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PREFACE 



This manual describes the PDP-11 MACRO-11 Assembler and 
Assembly Language. It also describes, in brief, how to program 
the PDP-11 computer. It is recommended that the reader have with 
him copies of the PDP-11 Processor Handbook and, optionally, the 
PDP-11 Peripherals and Interfacing Handbook, References are made 
to these documents throughout this document (although this document 
does stand complete by itself, the additional material provides 
further details) . The user is also advised to obtain a PDP-11 
pocket Instruction List card for easy reference. (These items 
can be obtained from the DEC Software Distribution Center.) 

MACRO-11 operates under the PDP-11 DOS (Disk Operating System) 
Monitor and the PDP-11 BATCH Monitor. 

Some notable features of MACRO-11 are: 

1. Program and command string control of assembly 
functions . 

2. Device and file name specifications for input and 
output files 

3. Error listing on command output device 

4. Double buffered and concurrent I/O 

5. Alphabetized, formatted symbol table listing 

6. Relocatable object modules 

7. Global symbols for linking between object modules 

8. Conditional assembly directives 

9. Program sectioning directives 

10. User defined macros 

11. Comprehensive set of system macros 

12. Extensive listing control 

13. Symbolic cross referencing. 
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SOFTWARE SUPPORT CATEGORIES 



Digital Equipment Corporation (DEC) makes available four categories of software. These 
categories reflect the types of support a customer may expect from DEC for a specified software 
product. DEC reserves the right to change the category of a software product at any time. 
The four categories are as follows: 



CATEGORY I 
Software Products Supported at no Charge 

This classification includes current versions of monitors, programming languages, and 
support programs provided by DEC. DEC will provide installation (when applicable), advisory, 
and remedial support at no charge. These services are limited to original purchasers of DEC 
computer systems who have the requisite DEC equipment and software products. 

At the option of DEC, a software product may be recategorized from Category I to 
Category II for a particular customer if the software product has been modified by the customer 
or a third party . 



CATEGORY II 
Software Products that Receive Support for a Fee 

This category includes prior versions of Category I programs and all other programs avail- 
able from DEC for which support is given. Programming assistance (additional support), as 
available, will be provided on these DEC programs and non-DEC programs when used in con- 
junction with these DEC programs and equipment supplied by DEC . 



CATEGORY III 
Pre-Release Software 

DEC may elect to release certain software products to customers in order to facilitate 
final testing and/or customer familiarization. In this event, DEC will limit the use of such 
pre-release software to internal, non-competitive applications. Category III software is only 
supported by DEC where this support is consistent with evaluation of the software product. 
While DEC will be grateful for the reporting of any criticism and suggestions pertaining to a 
pre-release, there exists no commitment to respond to these reports. 



CATEGORY IV 
Non-Supported Software 

This category includes all programs for which no support is given 
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CHAPTER 1 



FUNDAMENTALS OF PROGRAMMING THE PDP-11 

This Chapter presents some fundamental software concepts es- 
sential to efficient assembly language programming of the PDP-11 
computer. A description of the hardware components of the PDP-11 
family can be found in the two DEC paperback handbooks: 

PDP-11 Processor Handbook (11/20 or 11/45 edition) 
PDP-11 Peripherals and Interfacing Handbook 

No attempt is made in this document to describe the PDP-11 
hardware or the function of the various PDP-11 instructions. The 
reader is advised to become familiar with this material before pro- 
ceeding. 

The new PDP-11 programmer is advised to read this Chapter 
before reading further in this manual. The concepts in this 
Chapter will create a conceptual matrix within which explanations 
of the language fit. Since these are the techniques found to work 
best with the PDP-11 and are used in PDP-11 system programs, it is 
advisable to be considering them from the very start of your PDP-11 
programming experience. 

1.1 MODULAR PROGRAMMING 

The PDP-11 family of computers lend themselves most easily 
to a modular system of programming. In such a system the program- 
mer must envision the entire program and break it down into con- 
stituent subroutines. This will provide for the best use of the 
PDP-11 hardware (as will become clearer later in this Chapter) , 
as well as resulting in programs which are more easily modified 
than those coded with straight-line coding techniques. 

To this end, flowcharting of the entire system is best per- 
formed prior to coding rather than during or after the coding 
effort. The programmer is then able to attack small bits of the 
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program at any one time. Subroutines of approximately one or two 
pages are considered desirable. 

Modular programming practices maximize the usefulness of an 
installation's resources. Programmed modules can be used in other 
programs or systems where similar or identical functions are re- 
quired without the overhead of redundant development. Software 
modules devloped as functional entities are more likely to be 
free of serious logical errors as a result of the original pro- 
gramming effort. Confidence in such modules allows for easy crea- 
tion of later systems incorporating proven pieces. 

Modular development provides for ease of use and modification 
rather than simplifying the original development. Some pains must 
be taken to ensure correct modular system development, but the 
benefits of standardization to the generations of maintenance pro- 
grammers which deal with a given system are many. (See also the 
notes under Commenting Assembly Language Programs.) 

Modular development forces an awareness of the final system. 
Ideally, this should cause all components of the system to be 
considered from the very beginning of the development effort 
rather than patched into a partially-developed system. 

It is assumed that the human mind can best work with limited 
pieces of information at any one time, combining the results of 
the individual functions to encompass the entire program in steps. 
PDP-11 assembly language programming best follows a tree-like 
structure with the top of the tree being the final results and 
the base being the smallest component functions. (The Assembler 
itself is a tree structure and is briefly described in Figure 1-1.) 

1.1.1 Commenting PDP-11 Assembly Language Programs 

When programming in a modular fashion, it is desirable to 
heavily comment the beginning of each subroutine, telling what 
that routine does: its inputs, outputs, and register usage. 

Since subroutines are short and encompass only one operation 
it is not necessary to tell how the subroutine functions, but only 
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Figure 1-1 Problem Oriented Tree-Structure 
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what it does. The how should be documented only when the procedure 
is not obvious to the reader. This enables any later inspection 
of the subroutine to disclose the maximum amount of useful informa- 
tion to the reader. 

1.1.2 Localized Register Usage 

A useful technique in writing subroutines is to save all regis- 
ters upon entering a subroutine and restore them prior to leaving 
the subroutine. This allows the programmer unrestricted use of the 
PDP-11 registers, including the program stack, during a subroutine. 

Use of registers avoids two and three-word addressing instruc- 
tions. The code in Figure 1-2 compares the use of registers with 
symbolic addressing. Register use is faster and requires less stor- 
age space than symbolic addressing. 

1.1.3 Conditional Assemblies 

Conditional assemblies are valuable in macro definitions. The 
expansion of a macro can be altered during assembly as a result of 
specific arguments passed and their use in conditionals. For example, 
a macro can be written to handle a given data item differently, de- 
pending upon the value of the item. Only a single algorithm need be 
expanded with each macro call. (Conditionals are described in detail 
in Section 6.11.) 

Conditional assemblies can also be used to generate versions of 
a program from a single source. This is usually done as a result of 
one or more symbols being either defined or undefined. Conditional 
assemblies are preferred to the creation of a multiplicity of 
sources. This principle is followed in the creation of PDP-11 system 
programs for the following reasons: 

a. Maintenance of a single source program is easier, 
and guarantees that a change in one version of the 
program, which may affect other versions, is re- 
flected automatically in all possible versions. 
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Figure 1-2 Segment of PDP-11 Code 

Showing 1, 2, and 3-word Instructions 
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b. Distribution of a single source program allows a 
customer or individual user to tailor a system to 
his configuration and needs , and continue to up- 
date the system as the hardware environment or 
programming requirements change. 

c. As in the case of maintenance, the debugging and 
checkout phase of a single program (even one con- 
taining many separate modules) is easier than the 
testing of several distinct versions of the same 
basic program, 

1.2 POSITION INDEPENDENT CODE (PIC ) 

NOTE 

As this Section is quite detailed, it may be 
bypassed in the initial reading of the manual. 

The output of MACRO-11 (and PAL-11R) assemblies is a relo- 
catable object module. This module, under DOS, is linked (with 
Link-11) to a specified address prior to being executed. 



Once linked, a program can generally be loaded and executed 
only at the address specified at link time. This is because the 
Linker has had to make adjustments in some lines to reflect the 
absolute area of core (locations) in which the program is to run. 



It is possible to write a source program than can 
be loaded and run in any section of core. Such a program is 
said to consist of position independent code. The construction 
of position independent code is dependent upon the correct usage 
of PDP-11 addressing modes. (Addressing modes are described in 
detail in Chapter 5. The remainder of this Section assumes the 
reader is familiar with the various addressing modes.) 



All addressing modes involving only register references are 
position independent. These modes are as follows: 



R register mode 

@R deferred register mode 

(R)+ autoincrement mode 

@(R)+ deferred autoincrement mode 

-(R) autodecrement mode 

@- (R) deferred autodecrement mode 



When using these addressing modes, position independence is guaran- 
teed providing the contents of the registers have been supplied 
such that they are not dependent upon a particular core location. 
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The relative addressing modes are generally position indepen- 
dent. These modes are as follows: 

A relative mode 

OA relative deferred mode 

Relative modes are not position independent when A is an ab- 
solute address (that is, a non-relocatable address) and is refer- 
enced from a relocatable module. 

Index modes can be either position independent or nonposition 
independent , according to their usage in the program. These modes 
are : 

X (R) index mode 

@X(R) index deferred mode 

Where the base, X, is position independent, the reference is also 
position independent. For example: 

MOV 2(SP),R0 ;POSITION INDEPENDENT 
N=4 

MOV N(SP),R0 ;POSITION INDEPENDENT 

CLR ADDR(Rl) ;NONPOSITION INDEPENDENT 

Caution must be exercised in the use of index modes in position 
independent code. 

Immediate mode can also be either position independent or 
not, according to its usage. Immediate mode references are for- 
matted as follows: 

#N immediate mode 

Where an absolute number or a symbol defined by an absolute direct 
assignment replaces N, the code is position independent. Where a 
label replaces N, the code is nonposition independent. (That is, 
immediate mode references are position independent only where N 
is an absolute value.) 

Absolute mode addressing is unlikely to be position inde- 
pendent and should be avoided when coding position independently. 
Absolute mode addressing references are formatted as follows: 

@#A absolute mode 

Since this mode is used to obtain the contents of a specific core 
address, it violates the intentions of position independent code. 
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Such a reference is_ position independent if A is an absolute address. 



Position independent code is used in writing programs such as 
device drivers and utility routines which are most useful when 
they can be brought into any available core space. Figure 1-3 and 
Figure 1-4 show pieces of device driver code; one of which is posi- 
tion independent and the other is not. 



; DVRINT ~ ADDRESS OF DEVICE DRIVER INTERRUPT SERVICE 

; VECTOR — ABSOLUTE ADDRESS OF DEVICE INTERRUPT VECTOR 

; DRIVER — START ADDRESS OF DEVICE PRIVER 

MOV # DVRINT , VECTOR ; SET INTERRUPT ADDRESS 

MOVB DRIVER+6 , VECTOR* 2 ;SET PRIORITY 

CLRB VECTOR+3 ; CLEAR UPPER STATUS BYTE 



Figure 1-3 Non-Position Independent Code 



MOV 


PC,R1 


; GET DRIVER START 


ADD 


#DRIVER- . ,R1 




MOV 


#VECTOR,R2 


; . . . & VECTOR ADDRESSES 


CLR 


@R2 


;SET INTERRUPT ADDRESS 


MOVB 


5(R1) ,@R2 


;...AS START ADDRESS+OFFSET 


ADD 


Rl, (R2)+ 




CLR 


@R2 


;SET PRIORITY 


MOVB 


6 (Rl) ,@R2 





Figure 1-4 Position Independent Code 



In both examples it is assumed that the program calling the device 
driver has correctly initialized its interrupt vector (VECTOR) 
within absolute memory locations 0-377. The interrupt entry point 
offset is in byte DRIVER+5. (The contents of the Driver Table 
shows at DRIVER+5: .BYTE DVRINT-DRIVER. ) The priority level is 
at byte DRIVER+6. 

In the first example, the interrupt address is directly in- 
serted into the absolute address of VECTOR. Neither of these ad- 
dressing modes are position independent. 

The instruction to initialize the driver priority level uses 
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an offset from the beginning of the driver code to the priority 
value and places that value into the absolute address VECTOR+2 
(which is not position independent) . The final operation clearing 
the absolute address VECTOR+3 is also not position independent. 

In the position independent code, operations are performed 
in registers wherever possible. The process of initializing re- 
gisters is carefully planned to be position independent. For ex- 
ample: the first two instructions obtain the starting address of 
the driver. The current PC value is loaded into Rl, and the off- 
set from the start of the driver to the current location is added to 
that value. Each of these operations is position independent. The 
immediate mode value of VECTOR is loaded into R2; which places 
the absolute address of the transfer vector into a register for 
later use. The transfer vector is then cleared, and the offset 
from the driver starting address is loaded into the vector. The 
starting address of the driver is then added into the vector, giv- 
ing the desired entry point to the driver. (This is equivalent 
to the first statement in Figure 1-3.) Since R2 has been updated 
to point to VECTOR+2, that location is then cleared and the priority 
level inserted into the appropriate byte. 

The position independent code demonstrates a principle of 
PDP-11 coding practice, which was discussed earlier; that is, the 
programmer is advised to work primarily with register addressing 
modes wherever possible, relying on the setup mechanism to deter- 
mine position independence. 

The MACRO-11 Assembler provides the user with a way of check- 
ing the position independence of his code. In an assembly listing, 
MACRO-11 inserts a 1 character following the contents of any word 
which requires the Linker to perform an operation. In some cases 
this character indicates a nonposition independent instruction, 
in other cases, it merely draws the user's attention to the use of 
a symbol which may or may not be position independent. The cases 
which cause a 1 character in the assembly listing are as follows: 

a. Absolute mode symbolic references are flagged with an 
1 character when the reference is not position inde- 
pendent. References are not flagged when they are 
position independent (i.e., absolute). For example: 

MOV @#ADDR,R1 ;PIC ONLY IF ADDR IS ABSOLUTE. 
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b. Index mode and index deferred mode references are 
flagged with an 1 character when the base is a 
symbolic label address (relocatable rather than 
an absolute value). For example: 

MOV ADDR(R1),R5 ;NON-PIC IF ADDR IS RELOCATABLE . 
MOV @ADDR(R1) ,R5 ;NON-PIC IF ADDR IS RELOCATABLE. 

c. Relative mode and relative deferred mode are flag- 
ged with an 1 character when the address specified 
is a global symbol. For example: 

MOV GLB1,R1 ;PIC WHEN GLB1 IS A GLOBAL SYMBOL. 

MOV @GLB1,R1 ;PIC WHEN GLB1 IS A GLOBAL SYMBOL. 

If the symbol is absolute, the reference is flagged 
and is not position independent. 

d. Immediate mode references to symbolic labels are 
always flagged with an 1 character. 

MOV #3,R0 ; ALWAYS POSITION INDEPENDENT. 

MOV #ADDR,R1 ; NON-PIC WHEN ADDR IS RELOCATABLE. 



Examples of assembly listings contining the 1 character are 



shown below: 



BFQ 
CALL 

T55T 



1 01 1744 EMDP2! 
2 

3 011744 0167*2 

000142 1 

4 011750 001402 
£ 01 175? 

6 e 5 1756 8fl 
7 

e 011756 00*767 

000542 » 

5 01 176? 001423 
10 11764 
1 1 1 1770 012767 

000006 
000542 1 

12 11776 
13 

14 12*0? 032767 

000002 
000124 » 

15 12919 001010 BK'E 

16 12*12 <M67<>0 MOV 

000536 » 

17 12016 016720 MP V 

000044 ' 

18 12022 010067 MH V 

000536 t 

19 12026 CALL 

20 .FNDC 

21 12032 50*767 191 TST* 

000546 • 

22 12036 001474 BFQ 

23 1204? 032767 BTT 

040000 
000 1 1 0 • 



. IF KDF XtPFF 
MPV CFFPKT,P2 



CPFTMP 



BIKTYP 



BFQ If 
CALL OPJPMP 
Mfl V *PL*T*6»BI KTYP 



CALL RI.CTMP 
« IF KTF X IF D A B $ 
BTT *FC t ARg,EnMAS»< 



1 J 

OPJFKT # P0 

EKCVEC+6, fR0)* 

R0,CBJPNT 

OP JTMP 

L L T P L + 2 

If S 

*l C ,SYH, LTMAS^ 



fFNrt TF PAS? 5 ? 

) A NY CFiFF IK! PRfGPESS? 

i K'O 

?VE5f Cl'MP ANT tLCSF PUFF F P 
lANV CBJFtT OLTPtT? 

> *e 

|VF?f Cl'MP TT 
|$ET FKP 

ifHJMP IT 
lARS CLTPl«T? 

ISET FKn VECTOR 



I ANY L I $ T T K £ rUTPUT? 
> WO 

fSYMRCL TAP L E SLPPRFSSirK? 
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24 


1 2046 


0011270 




Iff 


> YES 


26 


1 205? 


006067 


CLR 


L P p r N T 


IFOPCF MEW PAGE 






00001 0 1 








26 


12054 


00*067 


CLR 


RCLLPD 


!«ET FCP SYMBOL TABLE STAN' 






000006 1 








27 


1 2060 


012702 2SI 


MOV 


*L HBUF.R3 


fPOTMT TO STOPApF 






00154(? f 








28 


12064 


3ft 


NF XT 


3VMR0L 


f GET ThF K'EVT 8YMPGL 


29 


1 2074 


0014S6 


BFG 


20$ 


jr K'O ^ ORF 


30 


1.2076 




RP0UKP 




I UNPACK THE SYMPGL 


31 


12102 


012703 


MOV 


*ENTP2T »R J 








012334 * 








32 


12106 




CALL 


EN0P2P 




33 


12112 


012701 


MDV 


**GrE,R1 


fPOTNT TO MODE PITS 






0 W0 0 00 1 








34 


12116 


032711 


BTT 


#C£PFLG* (P11 


>OEFIKEO? 






000010 








25 


1212? 


001403 


BFQ 


4$ 




36 


12124 




CALL 


SFURC 




37 
36 


12130 


000404 


BP 


6f 




39 


1213? 


01270J 4*1 


MOV 


♦STARSf Rl 





1.3 REENTRANT CODE 

Both the interrupt handling hardware and the subroutine call 
instructions (JSR, RTS, EMT, and TRAP) facilitate writing reentrant 
code for the PDP-11. Reentrant code allows a single copy of a 
given subroutine or program to be shared by more than one process 
or task. This reduces the amount of core needed for multi-task ap- 
plications such as the concurrent servicing of peripheral devices. 

On the PDP-11, reentrant code depends upon the stack for 
storage of temporary data values and the current processing status. 
Presence of information in the stack is not affected by the chang- 
ing of operational control from one task to another. Control is 
always able to return to complete an operation which was begun 
earlier but not completed. 



1.4 PREFERRED ADDRESSING MODES 

Addressing modes are described in detail in Chapter 5. Basic- 
ally, the PDP-11 programmer has eight types of register addressing 
and four types of addressing through the PC register. Those opera- 
tions involving general register addressing take one word of core 
storage, while symbolic addressing can cost up to three words. 
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For example: 



MOV A,B 
MOV R0,R1 



; THREE WORDS OF STORAGE 
;ONE WORD OF STORAGE 



The user is advised to perform as many operations as possible 
with register addressing modes, and use the remaining addressing 
modes to preset the registers for an operation. This technique 
saves space and time over the course of a program. 

1.5 PARAMETER ASSIGNMENTS 

Parameter assignments should be used to enable a program to 
be easily followed through the use of a symbolic cross reference 
(CREF listing). For example: 



Another standard PDP-11 convention is to name the general registers 
as follows: 



RJ3T = %0f 
Rl = %1 
R2 = %2 
R3 = %3 
R4 = %4 
R5 = %5 

SP = %6 (processor stack pointer) 
PC = %7 (program counter) 



The PDP-11/45 floating-point accumulators are named by convention 
as follows: 



AC0 = %/Zf 
AC1 = %1 
AC 2 = %2 
AC 3 = %3 
AC 4 = %4 
ACS = %5 



Use of these standard symbols makes examination of another pro- 
grammer's code much easier than the use of random symbolic names 
or constants which do not appear on CREF listings. 



Where a register reference is made in a 2-bit field 
within a floating-point instruction, ACJ3 through 
AC 3 may be referenced. In such instructions the 
6-bit source or destination field can be filled with 
addressing modes 1 through 7 which reference the pro- 
cessor registers Rfl through R7 or addressing mode 0 
which references floating-point registers AQ0 through 
ACS. 



SYM=42 



MOV #SYM,R0 



NOTE 
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1.6 SPACE VS. TIMING TRADEOFFS 



On the PDP-11 , as on all computers/ some techniques lead to 
savings in storage space and others lead to decreased execution 
time. Only the individual user can determine which is the best 
combination of the two for his application. It is the purpose of 
this Section to describe several means of conserving core storage 
and/or saving time. 

1*6.1 Trap Handler 

The use of the trap handler and a dispatch table conserve 
core requirements in subroutine calling, but can lead to a decrease 
in execution speed due to indirect transfer of control. 
To illustrate , a subroutine call can be made in either of the fol- 
lowing ways : 

1. A JSR instruction which generally requires two PDP-11 words: 

JSR R5,SUBA 
but is direct and fast. 

2. A TRAP instruction which requires one PDP-11 word: 

TRAP N 

but is indirect and slower. The TRAP handler must use 
N to index through a dispatch table of subroutine ad- 
dresses and then JMP to the Nth subroutine in the table. 

1.6.2 Regis ter Increment 

The operation: 

CMPB (R0)+, (R0) + 

is preferable to? 

TST (R0)+ 

to increment Rj? by 2, especially where the initial contents of R0 
may be odd, but is slower. 

1.7 CONDITIONAL BRANCH INSTRUCTIONS 

When using the PDP-11 conditional branch instructions, it is 
imperative that the correct choice be made between the signed and 
the unsigned branches. 
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SIGNED 



UNSIGNED 



BGE 
BLT 
BGT 
BLE 



BHIS (BCC) 

BLO 

BHI 

BLOS (BCS) 



A common pitfall is to use a signed branch (e.g., BGT) when com- 
paring two memory addresses. A problem occurs when the two ad- 
dresses have opposite signs; that is , one address goes across the 
16K (100000 8 ) bound. This type of coding error usually appears as 
a result of re-linking at different addresses and/or a change in 
size of the program. 
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CHAPTER 2 



SOURCE PROGRAM FORMAT 

A source program is composed of a sequence of source lines , 
where each line contains a single assembly language statement. 
Each line is terminated by either a line feed or a vertical tab 
character (which increments the line count by 1) or a form feed 
character (which increments both the line count and page count 
by 1) . 

Since Edit-11 automatically appends a line feed to every car- 
riage return character , the user need not concern himself with the 
statement terminator. However, a carriage return character not 
followed by a statement terminator generates an error flag. A 
legal statement terminator not immediately preceded by a carriage 
return causes the Assembler to insert a carriage return character 
for listing purposes. 

An assembly language line can contain up to 132^ characters 
(exclusive of the statement terminator) . Beyond this limit, ex- 
cess characters are ignored and generate an error flag. 

2.1 STATEMENT FORMAT 

A statement can contain up to four fields which are identi- 
fied by order of appearance and by specified terminating characters. 
The general format of a MACRO-11 assembly language statement is: 

label: operator operand ; comments 

The label and comment fields are optional* The operator and oper- 
and fields are interdependent; either may be omitted depending 
upon the contents of the other. 

The Assembler interprets and processes these statements one 
by one, generating one or more binary instructions or data words 
or performing an assembly process. A statement must contain one 
of these fields and may contain all four types. (Blank lines are 
legal, ) 
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Some statements have one operand, for example: 
CLR RJ7 

while others have two, for example: 
MOV #344 ,R2 

An assembly language statement must be complete on one source line. 
No continuation lines are allowed. (If a continuation is attempted 
with a line feed under Edit-11 the Assembler interprets this as the 
statement terminator.) 



MACRO-11 source statements are formatted with Edit-11 such 
that use of the TAB character causes the statement fields to be 
aligned. For example: 



Label Operator 
Field Field 

MASK=-1J0 
REG EXP : 

ABSEXP 
REGTST: BIT 
BEO 

REGERR: ERROR 
REGERX : MOV 

BIC 

BR 



Operand 
Field 



# MASK, VALUE 

REGERX 

R 

#DEFFLG i REGFLG , MODE 
# MASK, VALUE 
ABSERX 



Comment 
Field 

REGISTER EXPRESSION 
MUST BE ABSOLUTE 
3 BITS? 
YES, OK 
NO, ERROR 



2.1.1 Label Field 

A label is a user-defined symbol which is assigned the value 
of the current location counter and entered into the user-defined 
symbol table. The value of the label may be either absolute or 
relocatable, depending on whether the location counter value is 
currently absolute or relocatable. In the latter case, the abso- 
lute value of the symbol is assigned by Link-11, i.e., the stated 
relocatable value plus the relocation constant. 

A label is a symbolic means of referring to a specific loca- 
tion within a program. If present, a label always occurs first 
in a statement and must be terminated by a colon. For example, 
if the current location is absolute 100g, the statement: 

ABCD: MOV A, B 

assigns the value 100 Q to the label ABCD. Subsequent reference to 
ABCD references location In this example if the location 
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counter were relocatable, the final value of ABCD would be 100g+K, 
where K is the location of the beginning of the relocatable section 
in which the label ABCD appears . 

More than one label may appear within a single label field; 
each label within the field has the same value. For example, if 
the current location counter is 100 g/ the multiple labels in the 
statement: 

ABC: $DD: A7 . 7 : MOV A,B 

cause each of the three labels ABC, $DD , and A7 . 7 to be equated 

to the value 100 q. (By convention, $ and . characters are reserved 

for use in system software symbols,) 

The first six characters of a label are significant. An er- 
ror code is generated if more than one label share the same first 
six characters. 

A symbol used as a label may not be redefined within the user 
program. An attempt to redefine a label results in an error 
flag in the assembly listing. 

2.1.2 Operator Field 

An operator field follows the label field in a statement, and 
may contain a macro call, an instruction mnemonic, or an assembler 
directive. The operator may be preceded by none, one or more labels 
and may be followed by one or more operands and/or a comment. 
Leading and trailing spaces and tabs are ignored. 

When the operator is a macro call, the Assembler inserts the 
appropriate code to expand the macro. When the operator is an 
instruction mnemonic, it specifies the instruction to be generated 
and the action to be performed on any operand (s) which follow. 
When the operator is an Assembler directive, it specifies a certain 
function or action to be performed during assembly. 

An operator is legally terminated by a space, tab, or any 
non-alphanumeric character (symbol component) . 
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Consider the following examples 

MOV A,B (space terminates the operator MOV) 
MOV@A,B (@ terminates the operator MOV) 

When the statement line does not contain an operand or comment, 
the operator is terminated by a carriage return followed by a line 
feed, vertical tab or form feed character. 

A blank operator field is interpreted as a .WORD assembler 
directive (See Section 6.3.2). 

2.1.3 Operand Field 

An operand is that part of a statement which is manipulated 
by the operator. Operands may be expressions, numbers, or sym- 
bolic or macro arguments (within the context of the operation) . 
When multiple operands appear within a statement, each is separated 
from the next by one of the following characters: comma, tab, space 
or paired angle brackets around one or more operands (see Section 
3.1.1). An operand may be preceded by an operator, label or other 
operand and followed by a comment. 

The operand field is terminated by a semicolon when followed 
by a comment, or by a statement terminator when the operand com- 
pletes the statement. For example: 

LABEL: MOV A, B ; COMMENT 

The space between MOV and A terminates the operator field and be- 
gins the operand field; a comma separates the operands A and B; 
a semicolon terminates the operand field and begins the comment 
field. 

2.1.4 Comment Field 

The comment field is optional and may contain any ASCII char- 
acters except null, rubout, carriage return, line feed, vertical 
tab or form feed. All other characters, even special characters 
with a defined usage, are ignored by the Assembler when appearing 
in the comment field. 
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The comment field may be preceded by one, any, none or all of the 
other three field types. Comments must begin with the semicolon 
character and end with a statement terminator. 

Comments do not affect assembly processing or program execu- 
tion, but are useful in source listings for later analysis, debug- 
ging, or documentation purposes. 

2.2 FORMAT CONTROL 

Horizontal or line formatting of the source program is con- 
trolled by the space and tab characters. These characters have no 
effect on the assembly process unless they are embedded within a 
symbol, number, or ASCII text; or unless they are used as the opera- 
tor field terminator. Thus, these characters can be used to pro- 
vide an orderly source program. A statement can be written: 

LABEL:MOV(SP)+,TAG;POP VALUE OFF STACK 
or, using formatting characters, it can be written: 

LABEL: MOV (SP)+,TAG ;POP VALUE OFF STACK 
which is easier to read in the context of a source program listing. 

Vertical formatting, i.e., page size, is controlled by the 
form feed character. A page of n lines is created by inserting a 
form feed (type the CTRL/FORM keys on the keyboard) after the nth 
line. (See also Section 6.1.6 for a description of page formatting 
with respect to macros and Section 6.1.3 for a description of assem- 
bly listing output.) 
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CHAPTER 3 



SYMBOLS AND EXPRESSIONS 



This Chapter describes the various components of legal MACRO-11 
expressions: the Assembler character set, symbol construction , 
numbers, operators, terms and expressions. 

3.1 CHARACTER SET 



The following characters are legal in MACRO-11 source programs: 

a. The letters A through Z. Both upper and lower case 
letters are acceptable, although, upon input, lower 
case letters are converted to upper case letters. 
Lower case letters can only be output by sending 
their ASCII values to the output device. This con- 
version is not true for .ASCII, .ASCIZ, ' (single 
quote) or 11 (double quote) statements if • ENABL LC 
is in effect. 

b. The digits 0 through 9. 

c. The characters . (period or dot) and $ (dollar sign) 
which are reserved for use in system program symbols. 

d. The following special characters: 



Character 

carriage return 
line feed 
form feed 
vertical tab 



tab 

space 

# 

( 



Designation 



} 



) 



> 
+ 



* 

/ 
& 



\ 



colon 

equal sign 
percent sign 



number sign 
at sign 

left parenthesis 
right parenthesis 
comma 

semi-colon 

left angle bracket 

right angle bracket 

plus sign 

minus sign 

asterisk 
slash 
ampersand 
exclamation 
double quote 
single quote 
up arrow 

backslash 



Function 
formatting character 

source statement terminators 



label terminator 
direct assignment indicator 
register term indicator 
item or field terminator 
item or field terminator 
immediate expression indicator 
deferred addressing indicator 
initial register indicator 
terminal register indicator 
operand field separator 
comment field indicator 
initial argument or expression 
indicator 

terminal argument or expression 
indicator 

arithmetic addition operator or 
auto increment indicator , 
arithmetic subtraction operator 
or auto decrement indicator 
arithmetic multiplication operator 
arithmetic division operator 
logical AND operator 
logical inclusive OR operator 
double ASCII character indicator 
single ASCII character indicator 
universal unary operator, argu- 
ment indicator 

macro numeric argument indicator 
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3.1.1 Separating and Delimiting Characters 



Reference is made in the remainder of the manual to legal 
separating characters and legal argument delimiters. These 
terms are defined below in Tables 3-1 and 3-2. 



TABLE 3-1 
Legal Separating Characters 



Character 


Definition 


Usage 


space 


one or more spaces 
and/or tabs 


A space is a legal separator 
only for argument operands. 
Spaces within expressions 
are ignored (see Section 3.8). 


r 


comma 


A comma is a legal separator 
for both expressions and 
argument operands. 



TABLE 3-2 



Legal Delimiting Characters 



Character 



A.. A 



Definition 



paired angle brackets 



Up arrow construction 
where the up arrow 
character is followed 
by an argument brack- 
eted by any paired 
printing characters. 



Usage 

Paired angle brackets are used 
to enclose an argument, parti- 
cularly when that argument 
contains separating characters. 
Paired angle brackets may be 
used anywhere in a program to 
enclose an expression for 
treatment as a term. 

This construction is equivalent 
in function to the paired angle 
brackets and is generally used 
only where the argument con- 
tains angle brackets. 



Where argument delimiting characters are used, they must bracket 
the first (and, optionally, any following) argument(s). The charac- 
ter < and the characters f\, where \ is any printing character, can 
be considered unary operators which cannot be immediately preceded 
by another argument. For example: 



.MACRO TEM <AB>C 
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indicates a macro definition with two arguments , while 



.MACRO TEL C<AB> 



has only one argument. The closing >, or matching character where 
the up arrow construction is used, acts as a separator. The opening 
argument delimiter does not act as an argument separator. 

Angle brackets can be nested as follows : 

<A<B>C> 
which reduces to: 

A<B>C 

and which is considered to be one argument in both forms. 
3.1.2 Illegal Characters 



A character can be illegal in one of two ways: 



a. A character which is not recognized as an element 
of the MACRO-11 character set is always an illegal 
character and causes immediate termination of the 
current line at that point, plus the output of an 
error flag in the assembly listing. For example: 

LABEL*-* A: MOV A, B 

Since the backarrow is not a recognized character, 
the entire line is treated as a: 

.WORD LABEL 

statement and is flagged in the listing. 

b. A legal MACRO-11 character may be illegal in con- 
text. Such a character generates a Q error on 
the assembly listing. 



3.1.3 Operator Characters 



Legal unary operators under MACRO-11 are as follows: 



Unary 
Operator 



Explanation 



Example 

(positive value of A, equi- 
valent to A) 



+ 



plus sign 



+A 



minus sign 



(negative, 2*s complement, 
value of A) 
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Unary 
Operator 



Ex planation 

up arrow, univer- 
sal unary operator 
(this usage is de- 
scribed in greater 
detail in Sections 
6.4.2 and 6.6.2). 



Example 

+ F3.0 (interprets 3.0 as a 

one word floating-point 
number) 

+C24 (interprets the one's 

complement value of 24 g ) 

iDl27 (interprets 127 as a deci- 
mal number) 

t034 (interprets 34 as an 
octal number) 



+B11000111 (interprets 11000111 as a 
binary value) 



The unary operators as described above can be used adjacent to each 
other in a term. For example: 



-%5 

+C+012 



Legal binary operators under MACRO-11 are as follows: 



Binary 
Operator 



/ 
& 



Explanation 

addition 

subtraction 

multiplication 

division 

logical AND 

logical inclusive OR 



Example 

A+B 
A-B 

A*B (16-bit product returned) 

A/B (16-bit quotient returned) 
A&B 
A! B 



All binary operators have the same priority. Items can be grouped 
for evaluation within an expression by enclosure in angle brackets. 
Terms in angle brackets are evaluated first , and remaining opera- 
tions are performed left to right. For example: 



.WORD 1+2*3 
. WORD l+<2*3> 



;IS 11 OCTAL 
; IS 7 OCTAL 
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3.2 MACRO-11 SYMBOLS 



There are three types of symbols: permanent, user-defined and 
macro. MACRO-11 maintains three types of symbol tables: the 
Permanent Symbol Table (PST) , the User Symbol Table (UST) and the 
Macro Symbol Table (MST) . The PST contains all the permanent symbols 
and is part of the MACRO-11 Assembler load module. The UST and MST 
are constructed as the source program is assembled; user-defined 
symbols are added to the table as they are encountered. 

3.2.1 Permanent Symbols 

Permanent symbols consist of the instruction mnemonics (Appen- 
dix B3) and assembler directives (Chapters 6 and 7 , Appendix B) . 
These symbols are a permanent part of the Assembler and need not be 
defined before being used in the source program. 

3.2.2 User-Defined and MACRO Symbols 

User-defined symbols are those used as labels (Section 2.1.1) 
or defined by direct assignment (Section 3.3). These symbols are 
added to the User Symbol Table as they are encountered during the 
first pass of the assembly. Macro symbols are those symbols used 
as macro names (Section 7.1). These symbols are added to the Macro 
Symbol Table as they are encountered during the assembly. 

User-defined and macro symbols can be composed of alphanumeric 
characters , dollar signs , and periods only; any other character 
is illegal. 

The $ and . characters are reserved for system software sym- 
bols (e.g., .READ, a system macro) and should not be inserted in 
user-defined or macro symbols. 

The following rules apply to the creation of user-defined and 
macro symbols: 

a. The first character must not be a number. 

b. Each symbol must be unique within the first 
six characters. 

c. A symbol can be written with more than six legal 
characters, but the seventh and subsequent char- 
acters are only checked for legality, and are not 
otherwise recognized by the Assembler. 
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d. Spaces, tabs, and illegal characters must not be 
embedded within a symbol. 

The value of a symbol depends upon its use in the program. A symbol 
in the operator field may be any one of the three symbol types. To 
determine the value of the symbol, the Assembler searches the three 
symbol tables in the following order: 

a. Macro Symbol Table 

b. Permanent Symbol Table 

c. User-Defined Symbol Table 

A symbol found in the operand field is sought in the 

a. User-Defined Symbol Table 

b. Permanent Symbol Table 

in that order. The Assembler never expects to find a macro name in 
an operand field. 

These search orders allow redefinition of Permanent Symbol 
Table entries as user-defined or macro symbols. The same name can 
also be assigned to both a macro and a label. 

User-defined symbols are either internal or external (global) . 
All user-defined symbols are internal unless explicitly defined as 
being global with the . GLOBL directive (see Section 6.10). 

Global symbols provide links between object modules. A global 
symbol which is defined as a label is generally called an entry 
point (to a section of code) . Such symbols are referenced from 
other object modules to transfer control throughout the load module 
(which may be composed of a number of object modules) . 

Since MACRO-11 provides program sectioning capabilities (Sec- 
tion 6.9), two types of internal symbols must be considered: 

a. symbols that belong to the current program section; 
and 

b. symbols that belong to other program sections. 
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In both cases, the symbol must be defined within the current as- 
sembly; the significance of the distinction is critical in evalu- 
ating expressions involving type (b) above (see Section 3.9). 

3.3 DIRECT ASSIGNMENT 

A direct assignment statement associates a symbol with a 
value. When a direct assignment statement defines a symbol for 
the first time, that symbol is entered into the user symbol table 
and the specified value is associated with it. A symbol may be 
redefined by assigning a new value to a previously defined symbol. 
The latest assigned value replaces any previous value assigned 
to a symbol. 

The general format for a direct assignment statement is: 

symbol = expression 

Symbols take on the relocatable or absolute attribute of 
their defining expression. However, if the defining expression 
is global, the symbol is not global unless explicitly defined as 
such in a . GLOBL directive (see Section 6.10). 

For example: 

A = 1 ;THE SYMBOL A IS EQUATED TO THE VALUE 1. 

B = , A-l&MASKLOW ; THE SYMBOL B IS EQUATED TO THE VALUE OF 
; THE EXPRESSION 

C: D = 3 ; THE SYMBOL D IS EQUATED TO 3. 

E: MOV # 1 , ABLE ; LABELS C AND E ARE EQUATED TO THE 

; LOCATION OF THE MOV COMMAND 

The following conventions apply to direct assignment state- 
ments : 

a. An equal sign (=) must separate the symbol from the 
expression defining the symbol value. 

b. A direct assignment statement is usually placed in 
the operator field and may be preceded by a label 
and followed by a comment. 

c. Only one symbol can be defined by any one direct 
assignment statement . 

d. Only one level of forward referencing is allowed. 
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Example of two levels of forward referencing (illegal) : 



X 



= Y 



Y = 



Z 



Z 



= 1 



X and Y are both undefined throughout pass 1. X is 
undefined throughout pass 2 and causes a U error flag in 
the assembly listing. 

3.4 REGISTER SYMBOLS 

The eight general registers of the PDP-11 are numbered 0 
through 7 and can be expressed in the source program as: 



where the digit indicating the specific register can be replaced 
by any legal term which can be evaluated during the first assembly 
pass. Use of such register designations does not result in any 
indication of register usage within the CREF listing. 

It is recommended that the programmer create and use symbolic 
names for all register references. A register symbol is defined 
in a direct assignment statement, among the first statements in 
the program. The defining expression of a register symbol must be 
absolute. For example: 



%0 
%1 



%7 



e 

n 

12 
13 
14 
\S 
16 
17 
18 
19 



P0pepi 
p. ia p e p 4 



R 1 • % 1 

SP«%6 
R7«*7 



f PFGIMFP DFFTNTTJC-N 
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The symbolic names assigned to the registers in the example above 
are the conventional names used in all PDP-11 system programs. 
Since these names are fairly mnemonic, it is suggested the user 
follow this convention. Registers 6 and 7 are given special names 
because of their special functions, while registers 0 through 5 are 
given similar names to denote their status as general purpose regis- 
ters . 

All register symbols must be defined before they are refer- 
enced. A forward reference to a register symbol is flagged as an 
error. 

Although its use is not noted in CREF listings, the % character 
can be used with any term or expression to specify a register. (A 
register expression less than 0 or greater than 7 is flagged with 
an R error code.) For example: 

CLR %3+l 

is equivalent to 

CLR %4 

and clears the contents of register 4, while 
CLR 4 

clears the contents of memory address 4. 

In certain cases a register can be referenced without the 
use of a register symbol or register expression; these cases are 
recognized through the context of the statement. An example is 
shown below: 

JSR 5,SUBR ; FIRST OPERAND FIELD MUST ALWAYS BE A REGISTER 

3.5 LOCAL SYMBOLS 

Local symbols are specially formatted symbols used as labels 
within a given range. Use of local symbols can achieve a consider- 
able savings in core space within the user symbol table. Core cost 
is one word for each local symbol in each local symbol block, as 
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compared with four words of storage for each label stored in the 
User Symbol Table. 

Local symbols provide a convenient means of generating labels 
for branch instructions, etc. Use of local symbols reduces the 
possibility of multiply-defined symbols within a user program and 
separates entry point symbols from local references. Local symbols, 
then, are not referenced from other object moudles or even from 
outside their local symbol block. 

Local symbols are of the form n$ where n is a decimal integer 
from 1 to 127, inclusive, and can only be used on word boundaries. 
Local symbols include: 

1$ 
27$ 
59$ 
104$ 

Within a local symbol block, local symbols can be defined and 
referenced. However, a local symbol cannot be referenced outside 
the block in which it is defined. There is no conflict with 
labels of the same name in other local symbol blocks. 

Local symbols 64$ through 127$ can be generated automatically 

as a feature of the macro processor (see Section 7.3.5 for further 

details) . When using local symbols the user is advised to first 
use the range from 1$ to 63$. 

A local symbol block is delimited in one of the following ways: 

a. The range of a single local symbol block can consist 
of those statements between two normally constructed 
symbolic labels. (Note that a statement of the form 

LABEL= . 

is a direct assignment, does not create a label in 
the strict sense, and does not delimit a local range.) 

b. The range of a local symbol block is terminated 
upon encountering a .CSECT directive. 

c. The range of a single local symbol block can be 
delimited with the . ENABL LSB and the first sym- 
bolic label or .CSECT directive following the 

. DSABL LSB directives. The default for LSB is off. 

For examples of local symbols and local symbol blocks, see 
Figure 3-3. 
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I^IXER MO*E SFCTCR 
Figure 3-3 

Assembly Source Listing of MACRO-11 Code Showing Local Symbol Blocks 



The maximum offset of a local symbol from the base of its 
local symbol blocks is 128 decimal words. Symbols beyond this 
range are flagged with an A error code. 



3.6 ASSEMBLY LOCATION COUNTER 

The period (.) is the symbol for the assembly location 
counter. When used in the operand field of an instruction, it 
represents the address of the first word of the instruction. When 
used in the operand field of an assembler directive, it represents 
the address of the current byte or word. For example: 



MOV # . , RJJ 



. REFERS TO LOCATION A, 
I.E., THE ADDRESS OF THE 
MOV INSTRUCTION. 



(# is explained in Section 5.9). 

At the beginning of each assembly pass, the Assembler clears 
the location counter. Normally, consecutive memory locations are 
assigned to each byte of object data generated. However, the 
location where the object data is stored may be changed by a 
direct assignment altering the location counter: 

.=expression 

Similar to other symbols, the location counter symbol has a 
mode associated with it, either absolute or relocatable. However, 
the mode cannot be external. The existing mode of the location 
counter cannot be changed by using a defining expression of a 
different mode. 

The mode of the location counter symbol can be changed by 
the use of the .ASECT or .CSECT directive as explained in Section 
6.9. 

The expression defining the location counter must not contain 
forward references or symbols that vary from one pass to another. 
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Examples : 



. ASECT 



FIRST: MOV .+10, COUNT 



.=520 



SECOND : MOV . , INDEX 



.CSECT 
.=.+20 

THIRD: .WORD 0 



;SET LOCATION COUNTER TO ABSOLUTE 
;500 

; THE LABEL FIRST HAS THE VALUE 500(8) 
;.+10 EQUALS 510 (8). THE CONTENTS OF 
; THE LOCATION 510(8) WILL BE DEPOSITED 
;IN LOCATION COUNT. 

; THE ASSEMBLY LOCATION COUNTER NOW 
;HAS A VALUE OF ABSOLUTE 520(8). 

; THE LABEL SECOND HAS THE VALUE 520(8) 
; THE CONTENTS OF LOCATION 520(8), THAT 
;IS, THE BINARY CODE FOR THE INSTRUC- 
TION ITSELF, WILL BE DEPOSITED IN 
; LOCATION INDEX. 



;SET LOCATION COUNTER TO RELOCATABLE 
;20 OF THE UNNAMED PROGRAM SECTION. 

; THE LABEL THIRD HAS THE VALUE OF 
; RELOCATABLE 20. 



Storage area may be reserved by advancing the location counter, 
For example, if the current value of the location counter is 1000, 
the direct assignment statement 

.=.+100 



reserves 100 Q bytes of storage space in the program. The next 
instruction is stored at 1100. 



3.7 NUMBERS 

The MACRO-11 Assembler assumes all numbers in the source pro- 
gram are to be interpreted in octal radix unless otherwise speci- 
fied. The assumed radix can be altered with the .RADIX directive 
(see Section 6.4.1) or individual numbers can be treated as being 
of decimal, binary, or octal radix (see Section 6.4.2). 
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Octal numbers consist of the digits jZf through 7 only. A 
number not specified as a decimal number and containing an 8 or 9 
is flagged with an N error code and treated as a decimal number. 

Negative numbers are preceded by a minus sign (the Assembler 
translates them into two's complement form). Positive numbers may 
be preceded by a plus sign, although this is not required. 

A number which is too large to fit into 16 bits (177777 <n) 
is truncated from the left and flagged with a T error code in the 
assembly listing. 

Numbers are always considered absolute quantities (that is, 
not relocatable) . 

The single-word floating-point numbers which can be generated 

with the operator (see Section 6.4.2) are stored in the follow- 
ing format: 

15 14 7 6 JZf 

sign bit 8-bit exponent 7-bit mantissa 

Refer to PDP-11/45 Processor Handbook for details of the floating- 
point format. 

3 . 8 TERMS 



A term is a component of an expression. A term may be one of 
the following: 

a. A number, as defined in Section 3.7, whose 16-bit 
value is used. 

b. A symbol, as defined earlier in the Chapter. Symbols 
are interpreted according to the following hierarchy: 

1. a period causes the value of the current 
location counter to be used 

2. a permanent symbol whose basic value is 
used and whose arguments (if any) are 
ignored, 

3. an undefined symbol is assigned a value of 

zero and inserted in the user-defined symbol table. 
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c. An ASCII conversion using either an apostrophe followed 
by a single ASCII character or a double quote followed 
by two ASCII characters which results in a word con- 
taining the 7-bit ASCII value of the character (s) • (This 
construction is explained in greater detail in Section 
6.3.3.) 

d. A term may also be an expression or term enclosed in 
angle brackets. Any quantity enclosed in angle brackets 
is evaluated before the remainder of the expression in 
which it is found. Angle brackets are used to alter the 
left to right evaluation of expressions (to differentiate 
between A*B+C and A* <B+C>) or to apply a unary operator 
to an entire expression (-<A+B>, for example). 



3.9 EXPRESSIONS 



Expressions are combinations of terms joined together by binary 
operators and which reduce to a 16-bit value. The operands of a 
.BYTE directive (see Section 6.3.1) are evaluated as word expressions 
before truncation to the low-order eight bits. Prior to truncation, 
the high-order byte must be zero or all ones (when byte value is 
negative, the sign bit is propagated) . The evaluation of an expres- 
sion includes the evaluation of the mode of the resultant expression; 
that is, absolute, relocatable or external. Expression modes are 
defined further below. 



Expressions are evaluated left to right with no operator hier- 
archy rules except that unary operators take precedence over binary 
operators. A term preceded by a unary operator can be considered 
as containing that unary operator. (Terms are evaluated, where 
necessary, before their use in expressions.) Multiple unary opera- 
tors are valid and are treated as follows: 



-+-A 



is equivalent to: 



-<+<-A>> 
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A missing term, expression or external symbol is interpreted 
as a zero. A missing operator is interpreted as +. A Q error flag 
is generated for each missing term or operator. For example: 



TAG ! LA 177777 



is evaluated as 



TAG ! LA+177777 



with a Q error flag on the assembly listing line. 



The value of an external expression is the value of the abso- 
lute part of the expression; e.g., EXT+A has a value of A. This 
is modified by the Linker to become EXT+A. 



Expressions, when evaluated, are either absolute, relocatable, 
or external. For the programmer writing position- independent code, 
the distinction is important. 



a. An expression is absolute if its value is fixed. 
An expression whose terms are numbers and ASCII 
conversions will have an absolute value. A re- 
locatable expression minus a relocatable term, where both 
items belong to the same program section, is also absolute. 

b. An expression is relocatable if its value is fixed 
relative to a base address but will have an offset 
value added when linked. Expressions whose terms 
contain labels defined in relocatable sections and 
periods (in relocatable sections) will have a re- 
locatable value. 

c. An expression is external (or global) if its value 
is only partially defined during assembly and is 
completed at link time. An expression whose terms 
contain a global symbol not defined in the current 
program is an external expression. External expres- 
sions have relocatable values at execution time if 
the global symbol is defined as being relocatable or 
absolute if the global symbol is defined as absolute. 
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CHAPTER 4 



RELOCATION AND LINKING 



The output of the MACRO-11 Assembler is an object module which 
must be processed by Link-11 before loading and execution, (See 
PDP-11 Link-11 Linker and Libr-11 Librarian Programmer's Manual for 
details.) The Linker essentially fixes (i.e., makes absolute) the 
values of external or relocatable symbols and turns the object 
module into a load module. 



To enable the Linker to fix the value of an expression, the 
Assembler issues certain directives to the Linker together with 
required parameters. In the case of relocatable expressions, the 
Linker adds the base of the associated relocatable section (the 
location in memory of relocatable 0) to the value of the relocatable 
expression provided by the Assembler. In the case of an external 
expression, the value of the external term in the expression is 
determined by the Linker (since the external symbol must be defined 
in one of the other object modules which are being linked together) 
and adds it to the value of the external expression provided by the 
Assembler. 



All instructions that are to be modified (as described in 
the previous paragraph) are marked with an apostrophe in the assem- 
bly listing (see also Section 1.2). Thus the binary text output 
looks as follows: 



005065 CLR EXTERNAL (5) 



005065 CLR EXTERNAL+6 (5) 
000006 1 



005065 CLR RELOCATABLE (5) 
000040 1 



VALUE OF EXTERNAL SYMBOL 
ASSEMBLED ZERO; WILL BE 
MODIFIED BY THE LINKER. 

THE ABSOLUTE PORTION OF THE 
EXPRESSION (000006) IS ADDED 
BY THE LINKER TO THE VALUE 
OF THE EXTERNAL SYMBOL 

ASSUMING WE ARE IN THE ABSOLUTE 
SECTION AND THE VALUE OF 
RELOCATABLE IS RELOCATABLE 40 
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CHAPTER 5 
ADDRESSING MODES 

The program counter (PC, register 7 of the eight general reg- 
isters) always contains the address of the next word to be fetched; 
i.e., the address of the next instruction to be executed, or the 
second or third word of the current instruction. 

In order to understand how the address modes operate and how 
they assemble, the action of the program counter must be understood. 
The key rule is: 

Whenever the processor implicitly uses the program counter 
to fetch a word from memory, the program counter is 
automatically incremented by two after the fetch . 

That is, when an instruction is fetched, the PC is incremented 
by two, so that it is pointing to the next word in memory; and, if 
an instruction uses indexing (Sections 5.7, 5.8 and 5.11) the pro- 
cessor uses the program counter to fetch the base from memory. 
Hence, using the rule above, the PC increments by two, and now 
points to the next word. 

The following conventions are used in this Section! 

a. Let E be any expression as defined in Chapter 3. 

b. Let R be a register expression. This is any expres- 
sion containing a term preceded by a % character or 
a symbol previously equated to such a term. 

Examples : 

RpT = %0 ; GENERAL REGISTER 0 

Rl = RjM-1 ; GENERAL REGISTER 1 

R2 = 1+%1 /GENERAL REGISTER 2 

c. Let ER be a register expression or an expression in 
the range 0 to 7 inclusive. 

d. Let A be a general address specification which pro- 
duces a 6-bit mode address field as described in 
Sections 3.1 and 3.2 of the PDP-11 Processor 
Handbook (both 11/20 and 11/45 versions) . 
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The addressing specifications, A, can be explained in terms 
of E, R, and ER as defined above. Each is illustrated with the 
single operand instruction CLR or double operand instruction MOV. 



5.1 



REGISTER MODE 



The register contains the operand. 



Format for A: 
Examples : 



R 

R0=%0 
CLR R0 



; DEFINE R0 AS REGISTER 
; CLEAR REGISTER 0 



5.2 REGISTER DEFERRED MODE 



The register contains the address of the operand. 



Format for A: 
Examples: 



@R or (ER) 

CLR @R1 
CLR (1) 



BOTH INSTRUCTIONS CLEAR 
THE WORD AT THE ADDRESS 
CONTAINED IN REGISTER 1 



5.3 



AUTOINCREMENT MODE 



The contents of the register are incremented immediately after 
being used as the address of the operand. (See note below.) 



Format for A: 
Examples : 



(ER) + 

CLR (R0) + 
CLR (R0+3)+ 
CLR (2)+ 



EACH INSTRUCTION CLEARS 
THE WORD AT THE ADDRESS 
CONTAINED IN THE SPECIFIED 
REGISTER AND INCREMENTS 
THAT REGISTER'S CONTENTS 
BY TWO 



NOTE 



Both JMP and JSR instructions using non-deferred 
autoincrement mode, autoincrement the register 
before its use on the PDP-11/20 (but not on the 
PDP-11/45 or 11/^5) . In double operand 
instructions of the addressing form %R,(R)+ or 
%R,-(R) where the source and destination registers 
are the same , the source operand is evaluated 
as the autoincremented or autodecremented value; 
but the destination register, at the time it is 
used, still contains the originally intended ef- 
fective address. In the following two examples, 
as executed on the PDP-11/20, R0 originally con- 
tains 100. 
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MOV R0, (0) + 



; THE QUANTITY 102 IS MOVED 
;TO LOCATION 100 



MOV R0,-(0) ; THE QUANTITY 76 IS MOVED 
;TO LOCATION 76 
The use of these forms should be avoided, as they 
are not compatible with the PDP-11/05 and 11/45. 



A Z error code is printed with each instruction which is not compatible 
among all members of the PDP-11 family. This is merely a warning code. 



5.4 AUTOINCREMENT DEFERRED MODE 

The register contains the pointer to the address of the oper- 
and. The contents of the register are incremented after being 
used . 



Format for A: 
Example : 



@ (ER) + 
CLR @(3)+ 



CONTENTS OF REGISTER 3 POINT 
TO ADDRESS OF WORD TO BE 
CLEARED BEFORE BEING INCRE- 
MENTED BY TWO 



5.5 



AUTODECREMENT MODE 



The contents of the register are decremented before being used 
as the address of the operand (see note under autoincrement mode) . 



Format for A: 
Examples : 



" (ER) 

CLR -(R0) 
CLR -(R0+3) 
CLR - (2) 



DECREMENT CONTENTS OF REGISTERS 
0, 3, AND 2 BY TWO BEFORE USING 
AS ADDRESSES OF WORDS TO BE 
CLEARED 



5.6 AUTODECREMENT DEFERRED MODE 

The contents of the register are decremented before being used 
as the pointer to the address of the operand. 



5-3 



Format for A: @- (ER) 



CLR @-(2) 



Example : 



DECREMENT CONTENTS OF REGISTER 
2 BY TWO BEFORE USING AS POINTER 
TO ADDRESS OF WORD TO BE CLEARED. 



5.7 



INDEX MODE 



The value of an expression E is stored as the second or third 
word of the instruction. The effective address is calculated as 
the value of E plus the contents of register ER. The value E is cal- 
led the base. 



Format for- A: 
Examples: 



E (ER) 

CLR X+2(R1) 
CLR -2 (3) 



; EFFECTIVE ADDRESS IS X+2 PLUS 
; THE CONTENTS OF REGISTER 1. 
; EFFECTIVE ADDRESS IS -2 PLUS 
; THE CONTENTS OF REGISTER 3. 



5.8 INDEX DEFERRED MODE 

An expression plus the contents of a register gives the pointer 
to the address of the operand. 

Format for A: @E (ER) 

Example: CLR @14(4) ; IF REGISTER 4 HOLDS 100 AND 

; LOCATION 114 HOLDS 2000, 
; LOCATION 2000 IS CLEARED. 



5.9 IMMEDIATE MODE 

The immediate mode allows the operand itself to be stored as 
the second or third word of the instruction. It is assembled as 
an autoincrement of register 7 , the PC. 

Format for A: #E 

Examples: MOV #100, R0 ;MOVE AN OCTAL 100 TO REGISTER 0 

MOV #X, R0 ;MOVE THE VALUE OF SYMBOL X TO 

; REGISTER 0 

The operation of this mode is explained as follows : 

The statement MOV #100, R3 assembles as two words. These are: 

0 1 2 7 0 3 
0 0 0 1 0 0 
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Just before this instruction is fetched and executed, the PC 
points to the first word of the instruction. The processor fetches 
the first word and increments the PC by two. The source operand 
mode is 27 (autoincrement the PC) . Thus the PC is used as a pointer 
to fetch the operand (the second word of the instruction) before 
being incremented by two, to point to the next instruction. 

5.10 ABSOLUTE MODE 

Absolute mode is the equivalent of immediate mode deferred. 
@#E specifies an absolute address which is stored in the second or 
third word of the instruction. Absolute mode is assembled as an 
autoincrement deferred of register 7, the PC. 

Format for A: @#E 

Examples: MOV @#100,R0 ;MOVE THE VALUE OF THE CONTENTS 

;OF LOCATION 100 TO REGISTER 0. 
CLR @#X ; CLEAR THE CONTENTS OF THE 

; LOCATION WHOSE ADDRESS IS X, 

5.11 RELATIVE MODE 

Relative mode is the normal mode for memory references. 
Format for A: E 

Examples: CLR 100 ; CLEAR LOCATION 100. 

MOV X r Y ;MOVE CONTENTS OF LOCATION X 

;TO LOCATION Y. 

Relative mode is assembled as index mode, using register 7, the PC, 
as the index register. The base of the address calculation, which 
is stored in the second or third word of the instruction, is not 
the address of the operand (as in index mode) , but the number 
which, when added tr the PC, becomes the address of the operand. 
Thus, the base is X-PC, which is called an offset. The operation 
is explained as follows: 

If the statement MOV 100, R3 is assembled at absolute location 
20, the assembled code is: 

Location 20: 0 16 7 0 3 

Location 22: 0 0 0 0 5 4 
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The processor fetches the MOV instruction and adds two to the PC 
so that it points to location 22. The source operand mode is 67; 
that is, indexed by the PC. To pick up the base, the processor 
fetches the word pointed to by the PC and adds two to the PC. The 
PC now points to location 24. To calculate the address of the 
source operand, the base is added to the designated register. That 
is, BASE+PC=54+24=lJ2f0, the operand address. 

Since the Assembler considers " . " as the address of the first 
word of the instruction, an equivalent index mode statement would 
be : 

MOV 100-.- 4 (PC) ,R3 

This mode is called relative because the operand address is cal- 
culated relative to the current PC. The base is the distance or 
offset (in bytes) between the operand and the current PC. If the 
operator and its operand are moved in memory so that the distance 
between the operator and data remains constant, the instruction 
will operate correctly anywhere in core. 



5.12 RELATIVE DEFERRED MODE 

Relative deferred mode is similar to relative mode, except 
that the expression, E, is used as the pointer to the address of 
the operand. 



Format for A: @E 
Example: MOV @X,Rj2f 



MOVE THE CONTENTS OF THE 
LOCATION WHOSE ADDRESS IS IN 
X INTO REGISTER 0 # 



5.13 TABLE OF MODE FORMS AND CODES 

Each instruction takes at least one word. Operands of the 
first six forms listed below, do not increase the length of an 
instruction. Each operand in one of the other modes, however, in- 
creases the instruction length by one word. 
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Form 



Mode 



Meaning 



Register mode 
Register deferred mode 
Autoincrement mode 
Autoincrement deferred mode 
Autodecrement mode 
Autodecrement deferred mode 



adds one word to the instruction 



Mode Meaning 



R 0n 

@R or (ER) In 

(ER)+ 2n 

@(ER)+ 3n 

- (ER) 4n 

@-(ER) 5n 



where n is the register number. 

Any of the following forms 
length: 

Form 



E (ER) 6n 

@E (ER) 7n 

#E 27 

@#E 37 

E 67 

@E 77 



Index mode 

Index deferred mode 

Immediate mode 

Absolute memory reference mode 
Relative mode 

Relative deferred reference mode 



where n is the register number. Note that in the last four forms, 
register 7 (the PC) is referenced. 

NOTE 

An alternate form for @R is (ER) . However, the 
form @(ER) is equivalent to @0 (ER) . 

The form @#E differs from the form E in that the 
second or third word of the instruction contains 
the absolute address of the operand rather than 
the relative distance between the operand and 
the PC. Thus, the instruction CLR @#10P clears 
absolute location 100 even if the instruction is 
moved from the point at which it was assembled. 
See the description of the .ENABLE AMA function 
in Section 6.2, which directs the assembly of all 
relative mode addresses as absolute mode addresses. 

5.14 BRANCH INSTRUCTION ADDRESSING 



The branch instructions are one word instructions. The high 
byte contains the op code and the low byte contains an 8-bit signed 
offset (7 bits plus sign) which specifies the branch address rela- 
tive to the PC. The hardware calculates the branch address as 
follows : 

a. Extend the sign of the offset through bits 8-15. 

b. Multiply the result by 2. This creates a word offset 
rather than a byte offset. 

c. Add the result to the PC to form the final branch 
address . 



The Assembler performs the reverse operation to form the byte 
offset from the specified address. Remember that when the offset 
is added to the PC, the PC is pointing to the word following the 
branch instruction; hence the factor -2 in the calculation. 

Byte offset = (E-PC)/2 truncated to eight bits. 

Since PC = .+2, we have 

Byte offset = (E-.-2)/2 truncated to eight bits. 

NOTE 

It is illegal to branch to a location specified 
as an external symbol, or to a relocatable sym- 
bol from within an absolute section, or to an 
absolute symbol or a relocatable symbol of an- 
other program section from within a relocatable 
section. 

The EMT and TRAP instructions do not use the low-order byte 
of the word. This allows information to be transferred to the 
trap handlers in the low-order byte. If EMT or TRAP is followed 
by an expression, the value is put into the low-order byte of the 
word. However, if the expression is too big (>377 g ) it is trun- 
cated to eight bits and a T error flag is generated. 
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CHAPTER 6 



GENERAL ASSEMBLER DIRECTIVES 



6.1 LISTING CONTROL DIRECTIVES 
6.1.1 .LIST and • NLIST 



Listing options can be specified in the text of a MACRO-11 
program through the .LIST and .NLIST directives. These are of 
the form: 



.LIST arg 
.NLIST arg 



where: arg represents one or more optional arguments. 

When used without arguments , the listing directives alter 
the listing level count. The listing level count causes the 
listing to be suppressed when it is negative. The count is 
initialized to zero, incremented for each .LIST and decremented 
for each .NLIST. For example: 



.MACRO LTEST ;LIST TEST 

;A-THIS LINE SHOULD LIST 
.NLIST 

;B-THIS LINE SHOULD NOT LIST 
.NLIST 

;C-THIS LINE SHOULD NOT LIST 
.LIST 

;D-THIS LINE SHOULD NOT LIST (LEVEL NOT BACK TO ZERO) 
.LIST 

;E-THIS LINE SHOULD LIST (LEVEL BACK TO ZERO) 
. ENDM 

LTEST ; CALL THE MACRO 

; A -THIS LINE SHOULD LIST 
.NLIST 
.LIST 

;E-THIS LIST SHOULD LIST (LEVEL BACK TO ZERO) 



The primary purpose of the level count is to allow macro 
expansions to be selectively listed and yet exit with the level 
returned to the status current during the macro call. 
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The use of arguments with the listing directives does not 
affect the level count; however, use of .LIST and . NLIST can 
be used to override the current listing control. For example: 



.MACRO XX 



.LIST 
X=. 

.NLIST 

. ENDM 
.NLIST ME 

XX 

.LIST 
X=. 



;LIST NEXT LINE 

;D0 NOT LIST REMAINDER 
;0F MACRO EXPANSION 

;DO NOT LIST MACRO EXPANSIONS 
;LIST NEXT LINE 



Allowable arguments for use with the listing directives are 
as follows (these arguments can be used singly or in combina- 
tion: 



Argument Default Function 

SEQ list Controls the listing of source line 

sequence numbers. Error flags are 
normally printed on the line preced- 
ing the questionable source state- 
ment. 



LOC list Controls the listing of the location 

counter (this field would not normally 
be suppressed) . 

BIN list Controls the listing of generated binary 

code. 

BEX list Controls listing of binary extensions; 

that is, those locations and binary 
contents beyond the first binary word 
(per source statement) . This is a sub- 
set of the BIN argument. 

SRC list Controls the listing of the source code. 

COM list Controls the listing of comments. This 

is a subset of the SRC argument and can 
be used to reduce listing time and/or 
space where comments are unnecessary. 

MD list Controls listing of macro definitions 

and repeat range expansions. 

MC list Controls listing of macro calls and 

repeat range expansions. 



6-2 



Argument Default Function 

ME no list Controls listing of macro expansions. 

MEB no list Controls listing of macro expansion 

binary code. A . LIST MEB causes only 
those macro expansion statements 
producing binary code to be listed. 
This is a subset of the ME argument. 



CND list Controls the listing of unsatisfied 

conditions and all .IF and . ENDC 
statements. This argument permits 
conditional assemblies to be listed 
without including unsatisfied code. 

LD no list Control listing of all listing 

directives having no arguments (those 
used to alter the listing level 
count) . 

TOC list Control listing of table of contents 

on pass 1 of the assembly (see Section 
6.1.4 describing the . SBTTL directive). 
The full assembly listing is printed 
during pass 1 of the assembly. 

TTM Teletype Controls listing output format. The 

mode TTM argument (the default case) 

causes output lines to be truncated to 
72 characters. Binary code is printed 
with the binary extensions below the 
first binary word. The alternative 
(.NLIST TTM) to Teletype mode is line 
printer mode, which is shown in 
Figure 6-1. 

SYM list Controls the listing of the symbol table 

for the assembly. 



An example of an assembly listing as sent to a 132 column line 
printer is shown in Figure 6-1. Notice that binary extensions for 
statements generating more than one word are spread horizontally on 
the source line. An example of an assembly listing as sent to a 
teleprinter is shown in Figure 6-2. Notice that binary extensions 
for statements generating more than one word are printed on subsequent 
lines . 

The listing options can also be specified through switches on 
the listing file specification in the command string to the MACRO- 11 
Assembler. These switches are: 



/LI : arg 
/NL : arg 



MACRO V0C9,SA f l 24-.MAY-72 MACRO V003A 8 1 26-MAY-72 005136 PAGE 28 

ASSLMBlE* PrtOPER 



1 


V) 0 1 7 6 o 






GETL I N 1 






i GET AN I NJrUT ^ \ NE 


2 


001766 








S A VREG 






3 


001772 


216702 


002020<* 


15 i 


MQV 


FFCNT 1 R0 


I ANY RESERVED FF'S? 


4 


001776 


2 0 1 4 2 3 






BEQ 


315 


1 NO 


5 


002020 


260067 


002022' 




ADD 


R0 ( PAGNUM 


fYES, UPDATE PAGE NUMBER 


6 


202024 


2127*7 


177777 000026? 




MOV 


#»1 f PAGEXT 




7 


2! 2! 2 0 i 2 


20506 7 


203012* 




CL^ 


LINNUM 


; I N I T NEW CREF SEQUENCE 


3 


232*516 


025067 


000020* 




CL.R 


FFCNT 




9 


332022 


205067 


202016* 




CUR 


5EQEN0 




10 


0^2026 


225767 


ja jM| r-« jw i 

0000001 




TST 


PASS 




11 


222032 


?014^2 






BEQ 


31$ 




12 


0232034 


205067 


000010^ 




CLR 


UPPCNT 




13 


« 2J2043 


212722 


201712* 


315 ! 


MOV 


#LIN3UF,R2 




14 


0 32044 


210267 


000212* 




MQV 


R2| LCBEGL 


I SEAT UP BEGINNING 


15 


232050 


212767 


002H6* 000014C 




MQV 


#LINENDi LCENDU 


* AND END OF ^ I NE MARKERS 


17 


222056 


20576 7 


200200' 




TST 


SMUCNT 


J IN SYSTEM MACRO? 


18 


222^62 


221145 






?NE 


405 


i YFSi SPECIAL, 


21 


222064 


216721 


202214/ 




MQV 


MSBMRP | Rl 


^ASSUME MACRO IN PROGRESS 


22 


222070 


201166 






BNE 


125 


j BRANCH IF SO 


24 


222072 


212721 


200756* 




MOV 


*SRC3UF,R1 




25 


032076 








» W A J T 


#SRCLNK 




26 


22213* 


205267 


000012* 




INC 


LINNUM 




27 


22211^ 


116720 


000753* 




MQVB 


SRCHOR+3,R0 


5 GET CODE BYTE 


28 


002H4 


232720 


000047 




BIT 


#347, R0 


^ANYTHING BAD? 


29 


2021?^ 


201423 






BEQ 


325 


; NO 


30 


202122 








ERROR 


L 


; YES , ERROR 


31 


C2213C 


106120 




325? 


R018 


R0 


1 EOF? 


32 


2221^ 


102014 






B?l 


2$ 


J NO 


33 


022134 


256767 


202006* 000004^ 




5 IS 


CSISAViENDPLG 




34 


202141 


201023 






BNE 


345 





Example of MACRO-11 Line Printer Listing 
(132 column line printer) 
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VBtf^A, 1 


24-flAY- 


72 


MAC«U VR?id3A« 1 










1 0&17Oe> 




&E i LlM 






2 0 kii 7 o o 










3 Bid 1/ / 2 


V' 10/ L- 


1$5 


nov 


PPCNl ,RU 




w 2 0 1 








4 WiiJl7/t> 


tfk? 142*3 




bfctj 


31« 


b 0 0 2 $ (0 w 


fel 0 a 7 




AOU 


Rifl # HAGNUM 




fes Ki 2 2 • 










1 2 7 f 7 




MQV 


*«l#t*AGfcKT 




17 7/7/ 










fe) 0 2 D 1 








7 8tf20l2 


fc< S t» 7 




CL« 


LiNNUM 




SO k) 1 2 » 








8 £)tf2fclb 


V3v3btob7 




CUH 


PPQNl 




^ (d 1/5 k» 2 » 








9 #02022 






tUN 


SEUiENQ 




0 6* « j 1 o ' 








10 02tf2g 


tiWS>7b7 




73! 


PASS 












11 tf2t$32 


fcfc 1 4 1*2 




SEw 


31 * 


12 tf2#34 






CLH 






V3 it) 1 it? f 








Id v42fci4tf 


to 12/^2 


31*: 


mqv 


WUlNbuP : ,K2 




*6f 0 1 / 12 • 








14 421^^4 


W A I42b7 




HOV 


N2 f LLBE&L 




\C to 1 2 ' 








lb 02^b^j 


$ 1 2 7 7 




MQV 


«LlNtND» LtENUU 




1 1 0 » 










V) fci W W 1 4 1 








lb 






.11" NOP 




1/ /i2«bk 


# w b 7 b 7 




1ST 






& w 2 kj Kf t 








lb #2#b2 


1 *.4b 




fc*Nt 


40» 


l y 






• ENQC 




2v3 






•IP NOP 




21 4 4 0 4 


r. 1 "J i,. 1 

t' 1 b / to 1 




MOV 






& ft 2 2 1 4 1 








22 fe32tf/tf 


fctf 1 IfcO 




BNt 


lfe?» 


23 






• I P T P 




24 tf2fc>/2 


127 v' 1 1 




MQV 






k3k)0/bb > 








2b 02t»/b 






« * A 1 T 




20 021^4 


tfub2*7 




INC 


L1NNMM 




fc? W 0 1 2 ■ 








2/ 02110 


1 1 0 7 ir ■ tf 




nova 






!^^^7b3 » 








2b t/1211* 


fc32/fc'tf 




fl i T 


#k347#rt0 




k:» u fen fei <a 7 








29 bi2l2fci 


k 1 0 1 4 (/ 4 




bEQ 


32$ 


3i>5 ^2122 






t«KOR 


U 


31 ^ is a ^ id 


l v!?e> i m 


3£*: 






32 '4213a 


lww&l4 






2* 


33 02134 


vjbb/b/ 




lb 






k! (o to ijj o 1 










fc? « u # i.'. 4 1 








34 tf2l«2 


tfWlUg3 






34$ 



IKbl AN INPUT L|N£ 
f AN Y KfcSfcRVfcQ FF'S? 
? NO 

^YfcS» UPDATE PAGE NUM9EK 



UNIT NEW CKEP" SEQUENCE 



;SEAT UP BfcGlNNlNG 

? ANU END OF LINE MARKERS 

I IN SYSTEM MACHO? 
; YEii, 3PECIAL 

;assume macro In progress 

fBKANCH IF SQ 



I GET COQt tSYTE 
fANYTHINb bAO? 
? NU 

f YES, E RHQK 

;eqf? 

f HQ 



Example of Page Heading from MACRO-11 Teletype Listing 
(same format as for 80 column line printer) . 

FIGURE 6-2 
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where: arg is any one or more of the arguments defined 

in the .LIST and . NLIST directives. 

NOTE 

Where no listing file specification is indicated, 
any errors encountered are printed on the tele- 
printer. Where the /NL switch is used with no 
argument, the errors and symbol table are output 
to the device and/or file specified. Use of the 
switches /NL and /NL:SYM cause the errors only 
to be sent to the file and/or device specified. 

Each argument used with a listing switch is preceded by a colon. 

Use of these switches overrides the enabling or disabling of 
the equivalent listing option in the source. Default listing 
controls can be specified by the user within his source and over- 
ridden, where necessary, by switch options at assembly time. For 
example : 

JOBJFIL, KB : /NL : BEX : COM/LI : SRC< DF : SRCFIL 

This command string suppresses the listing of binary exten- 
sions and source comments and ignores all listing directives with 
the arguments BEX, COM, and SRC. (The object file is sent to the 
system device and the listing and symbol table to the teleprinter.) 

JOB JFIL , LP : /LI< DTI : ABC 

causes MACRO-11 to ignore all .LIST and .NLIST directives without 
arguments . This command string causes the listing of any source 
code which would have otherwise been suppressed. (The object file 
is sent to the system device; the source listing and symbol table 
are sent to the line printer.) 

#OBJFIL,SYM/NL<ABC 

causes MACRO-11 to produce only an object file and a symbol table 
listing. The assembly listing is completely suppressed by the /NL 
switch. (The object file and symbol table file are sent to the 
system device. ) 
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Line Seq. Loc. Binary Field 

Nos. Field Binary Extension Field 



1 
2 
3 
4 
5 
6 
7 
8 
9 

10 000000 

000000 000001 000022 000003 
000006 000004 

11 

12 000010 

, NLIST 

000001 000002 000003 .WORD 



000004 



<i 13 



14 000020 

•NLIST BIN 
000020 .HOR-D li2,3,4 

15 

16 000030 

000030 000001 000002 000003 
000036 000004 

17 

18 000040 

000040 000001 000032 000003 
000046 000004 

19 

20 000050 

000050 000001 000002 000003 



Source Field 



Comment Field 



,NLI$T TIM ; ST ART OF F IN LP MODE 

•LIST ME ;LIST MACRO EXPANSIONS 

.MACRO ISTMAC APG JUSTING ARGUMENT TEST 

» NL 1ST ARG 

,W0R0 i,2,3>4 3 COMMENT 

.LIST ARG 
, ENQM 

LSTMAC SEQ jSEQENCr NUMBERS 

.NLIST SEQ 

.WORD 1,2,3,4 ; COMMENT 

.LIST SEQ 

LSTMAC LOC JLOCATIQH COUNTER 

LOC 

1,2,3*4 JCOMMENT 

•LIST LOC 

LSTMAC BIN ; BINARY 

I COMMENT 

,LIST BIN 

LSTMAC SRC sSOURCE 

.LIST SRC 

LSTMAC COM ; C 0 M M E N T 

,NLI$T COM 

.WORD 1,2 #3. 4 

.LIST COM. 

LSTMAC 3EX ; B I N A R Y EXTENSION LINE 

, NLIST 3EX 

.WORD 1,2,3,4 ; COMMENT 



Line 

Seq. Loc. 
Nos. Field 



Binary Field 

Binary Extension Field 



21 

22 .LIST TTH 

23 00060 000001 .WORD Ii2,3,4 
00062 000002 

00064 000003 
00066 000004 

24 

25 00070 LSTMAn <C0M*BEX> 

.NLIST C0M,B£X 
00070 000001 .WORD 1,2,3,4 



26 

27 
28 

29 000031 



.LIST COM, BEX 



Source Field 



Comment Field 



.LIS T HEX 

;TRY ABBREVIATED FORM 
-.COMMENT 



; C0M9INAT ION TEST 



, NL I 5 T TTM 
, END 



;5ac:k t= expandfc- listin 



6.1.2 Page Headings 



The MACRO-11 Assembler outputs each page in the format shown 
in Figure 6-2 (Teletype listing) . On the first line of each list- 
ing page the Assembler prints (from right to left) : 

a. title taken from • TITLE directive 

b. assembler version identification 

c . date 

d. time-of-day 

e. page number 

The second line of each listing page contains the subtitle text 
specified in the last encountered . SBTTL directive. 

6.1.3 . TITLE 

The .TITLE directive is used to assign a name to the object 
module. The name is the first symbol following the directive 
and must be six Radix-50 characters or less (any characters beyond 
the first six are ignored. Non Radix-50 characters are not accep- 
table. For example: 

.TITLE PROG TO PERFORM DAILY ACCOUNTING 

causes the object module of the assembled program to be named PROG 
(this name is distinguished from the filename of the object module 
specified in the command string to the Assembler) . The name of 
the object module appears in the Linker load map and on the listing. 

If there is no .TITLE statement, the default name assigned 
to the first object module is 

.MAIN. 

The first tab or space following the .TITLE directive is not 
considered part of the object module name or header text, although 
subsequent tabs and spaces are significant. 

If there is more than one .TITLE directive, the last .TITLE 
directive in the program conveys the name of the object module. 
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6.1.4 . SBTTL 



The .SBTTL directive is used to provide the elements for a printed 
table of contents of the assembly listing. The text following the 
directive is printed as the second line of each of the following 
assembly listing pages until the next occurrence of a .SBTTL directive. 
For example; 

.SBTTL CONDITIONAL ASSEMBLIES 

The text 

CONDITIONAL ASSEMBLIES 

is printed as the second line of each of the following assembly 
listing pages. 

During pass 1 of the assembly process, MACRO-11 automatically 
prints a table of contents for the listing containing the line sequence 
number and text of each .SBTTL directive in the program. Such a 
table of contents is inhibited by specifying the /NL : TOC switch option 
to the assembly listing file specification (or an . NLIST TOC directive 
within the source) . For example: 

fOBJFIL, LISTM/NL : TOC<SRCF IL 

In this case the table of contents normally generated prior to the 
assembly listing is inhibited. 

An example of the table of contents is shown in Figure 6-3. Note 
that the first word of the subtitle heading is not limited to six 
characters since it is not a module name. 

6.1.5 . I DENT 

The . IDENT directive provides another means of labeling the 
object module produced as a result of a MACRO-11 assembly. In 
addition to the name assigned to the object module with the .TITLE 
directive, a character string (up to six characters, treated like a 
RAD50 string) can be specified between paired delimiters. For example: 

. IDENT /V005A/ 
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MACHO Vk)tf3A,l 24-HAY-72 MACRU V®d3A*l 23-MAY-72 00831 

TABtt UF CONTENTS 



5- 1 SEWTUK INITIALIZATION 

7* 1 bUbRUuTlNE CALL DEFINITIONS 

12- X PAKAttETfcKS 

14- I RQUL LfcPJNITIONS 

lb- 1 PkUfcHAh INITIALIZATION 

26- t ASSfctftfLfc* PKUPtK 

3^-» 1 S T A T fc H fc N T PROCESSOR 

40- 1 ASSIGNMENT PROCESSOR 

41- 1 UP CUUfc PROCESSOR 

4H- 1 EXPRESSION TO LODfc-RULL CQNVfcRSIONS 

£»tf* 1 CpUfc KQLL STORAGE 

bt- I UIKEClIVtS 

59- 1 uAU-fctNtKATiNG OIRECrlVES 

6a- 1 CUNPITIONALS 

72- 1 LISTING COMROL 

74- 1 tNAbL/OSAdL FUNCTIONS 

7b- 1 CROSS REFERENCE M A N 0 LENS 

7tf- 1 LIFTING STUFF 

79- 1 KEYbUARQ HANUL&RS 

SW- 1 UcWfcCT CUDL HANDLERS 

da- 1 LIFTING OUTPUT 

92- 1 I/O buKFERS 

93- 1 EXPRESSION EVALUATUR 
99- 1 fb KM EVALUATUH 

I SYMbOL/LHAHACTER handlers 

109- 1 KQLL HANULtRS 
U4- 1 KfcUlSlER ST OH AWE 

110- 1 MALKtf HANDLERS 
US- 1 F IN 



Table of Contents text is taken from the text of each 
• SBTTL directive. The associated numbers are the page 
and line sequence numbers of the . SBTTL directives. 

Figure 6-3 Assembly Listing Table of Contents 
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The character string: 



V005A 



is converted to Radix-5j2f notation and output to the global symbol 
directory of the object module. 



This symbol can optionally be included in the load map listings 
output by the Linker. 

When more than one .IDENT directive is found in a given pro- 
gram, the last . IDENT found determines the symbol which is passed 
as part of the object module identification. 



6.1.6 Page Ejection 

There are several means of obtaining a page eject in a 
MACRO-11 assembly listing: 



a. After a line count of 58 lines, MACRO-11 automatically 
performs a page eject to skip over page perforations 
on line printer paper and to formulate Teletype output 
into pages. 

b. A form feed character used as a line terminator (or 
as the only character on a line) causes a page eject. 
Used within a macro definition a form feed character 
causes a page eject. A page eject is not performed 
when the macro is invoked. 

c. More commonly, the .PAGE directive is used within 

the source code to perform a page eject at that point. 
The format of this directive is 

.PAGE 

This directive takes no arguments and causes a skip 
to the top of the next page. 

Used within a macro definition, the .PAGE is ignored, 
but the page eject is performed at each invocation of 
that macro. 
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6.2 FUNCTIONS: . ENABL AND ♦ DSABL DIRECTIVES 



Several functions are provided by MACRO-11 through the .ENABL 
and .DSABL directives. These directives use three-character symbolic 
arguments to designate the desired function; and are of the forms: 



.ENABL arg 
.DSABL arg 



where ; 



arg 



is one of the legal symbolic arguments 
defined below. 



The following table describes the symbolic arguments and their associ- 
ated functions in the MACRO-11 language: 



Symbolic Argument 
ABS 



AMA 



CDR 



FPT 



LC 



LSB 



PNC 



Function 

Enabling of this function produces absolute 
binary output; i.e., input to the Paper Tape 
Software System Absolute Loader (with a .BIN 
extension instead of .OBJ) . The default case 
is .DSABL ABS; i.e., input to Link-11. 

Enabling of this function directs the assembly 
of all relative addresses (address mode 67) as 
absolute addresses (address mode 37) . This 
switch is useful during the debugging phase of 
program development. 

The statement .ENABL CDR causes source columns 
73 and greater to be treated as comment. This 
accommodates sequence numbers in card columns 
72-80. 

Enabling of this function causes floating point 
truncation, rather than rounding , as is other- 
wise performed. .DSABL FPT returns to floating 
point rounding mode. 

Enabling of this function causes the Assembler 
to accept lower case ASCII input instead of 
converting it to upper case. 

Enable or disable a local symbol block. While 
a local symbol block is normally entered by 
encountering a new symbolic label or .CSECT 
directive, .ENABL LSB forces a local symbol 
block which is not terminated until a label or 
.CSECT directive following the .DSABL LSB 
statement is encountered. The default case 
is .DSABL LSB. 

The statement .DSABL PNC inhibits binary out- 
put until an .ENABL PNC is encountered. The 
default case is .ENABL PNC. 



An incorrect argument causes the directive containing it to be 
flagged as an error. 
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Once a program has been written using these functions, or not 
using them, the functions can be controlled through switches 
specified in the command string to the MACRO-11 Assembler, These 
switches are: 

/EN:arg 
/DS:arg 

where: arg is any of the arguments defined for the . ENABL 

and • DSABL directives. 



Use of these switches overrides the enabling or disabling of all 
occurrences of that argument in the program. 
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6.3 DATA STORAGE DIRECTIVES 



A wide range of data and data types can be generated with the 
following directives and assembly characters: 



. BYTE 
.WORD 



.ASCII 
.ASCIZ 
. RAD50 
tB 
tD 

to 



These facilities are explained in the following Sections. 



6.3.1 . BYTE 



The .BYTE directive is used to generate successive bytes of 
data. The directive is of the form: 



.BYTE exp ; WHICH STORES THE OCTAL EQUIVALENT 

;0F THE EXPRESSION exp IN THE NEXT 
; BYTE . 

.BYTE expl,exp2, . . . ; WHICH STORES THE OCTAL EQUIVALENTS 

;0F THE LIST OF EXPRESSIONS IN SUC- 
CESSIVE BYTES. 



where a legal expression must have an absolute value (or contain a 
reference to an external symbol) and must result in 8 bits or less 
of data. The 16-bit value of the expression must have a high-order 
byte (which is truncated) that is either all zeros or all ones. 
Each operand expression is stored in a byte of the object program. 
Multiple operands are separated by commas and stored in successive 
bytes. For example: 



SAM=5 
.=410 

.BYTE +D48,SAM ;06j2f (OCTAL EQUIVALENT OF 48 DECIMAL) 

;IS STORED IN LOCATION 410, 005 IS 
; STORED IN LOCATION 411 . 



If the high-order byte of the expression equates to a value other 
than 0 or -1, it is truncated to the low-order 8 bits and flagged 
with a T error code. If the expression is relocatable , an A-type 
warning flag is given. 
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At link time it is likely that relocation will result in an expres- 
sion of more than 8 bits, in which case, the Linker prints an error 
code. For example: 



•BYTE 23 ; STORES OCTAL 23 IN NEXT BYTE. 

A: 

.BYTE A RELOCATABLE VALUE CAUSES AN "A" 

; ERROR FLAG. 

. GLOBL X 
X=3 

.BYTE X ; STORES 3 IN NEXT BYTE. 

In the case where X is defined in another program: 
.GLOBL X 

.BYTE X ? PRODUCES A "W" FLAG 

; SINCE THE STATEMENT IS NOT 
? ACCEPTABLE IF X IS A LABEL. 

If an operand following the .BYTE directive is null, it is 
interpreted as a zero. For example: 

.=420 

.BYTE ,, ;ZEROES ARE STORED IN BYTES 420, 421, AND 422, 

6.3.2 .WORD 

The .WORD directive is used to generate successive words of 
data. The directive is of the form: 

.WORD exp ; WHICH STORES THE OCTAL EQUIVALENT 

;0F THE EXPRESSION exp IN THE NEXT 
;WORD. 

.WORD expl,exp2, . . . ; WHICH STORES THE OCTAL EQUIVALENTS OF 

; THE LIST OF EXPRESSIONS IN SUCCESSIVE 
; WORDS . 

where a legal expression must result in 16 bits or less of data. 
Each operand expression is stored in a word of the object program. 
Multiple operands are separated by commas and stored in successive 
words. For example: 

SAL=0 
.=500 

.WORD 177535, .+4, SAL ; STORES 177535, 506, AND 0 IN 

; WORDS 500, 502, AND 504. 
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If an expression equates to a value of more than 16 bits, it 
is truncated and flagged with a T error code. 



If an operand following the .WORD directive is null, it is 
interpreted as zero. For example: 



.WORD 



=500 



,5, 



; STORES 0, 5, and 0 in LOCATIONS 500 
; 502, and 504. 



A blank operator field (any operator not recognized as a macro 
call, op-code, directive or semicolon) is interpreted as an implicit 
.WORD directive. Use of this convention is discouraged. The first 
term of the first expression in the operand field must not be an in- 
struction mnemonic or assembler directive unless preceded by a + or - 
operator. For example: 



Note that the default .WORD directive occurs whenever there is a 
leading arithmetic or logical operator, or whenever a leading symbol 
is encountered which is not recognized as a macro call, an instruction 
mnemonic or assembler directive. Therefore, if an instruction mnemonic, 
macro call or assembler directive is misspelled, the .WORD directive 
is assumed and errors will result . Assume that MOV is spelled incor- 
rectly as MOR: 



Two error codes result: Q occurs because an expression operator is 
missing between MOR and A, and a U occurs if MOR is undefined. Two 
words are then generated: one for MOR A and one for B. 

6.3.3 ASCII Conversion of One or Two Characters 

The 1 and " characters are used to generate text character within 
the source text. A single apostrophe followed by a character results 
in a word in which the 7-bit ASCII representation of the character is 
placed in the low-order byte and zero is placed in the high-order byte. 
For example: 



.=440 
LABEL: +MOV, LABEL 



;THE OP-CODE FOR MOV, WHICH IS 010000, 
;IS STORED ON LOCATION 440. 
;440 IS STORED IN LOCATION 442. 



MOR A,B 
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MOV #'A,R0 



results in the following 16 bits being moved into R0: 

15 8 7 0 



101 



octal ASCII value of A 



The 1 character is never followed by a carriage return, null, rubout, 
line feed or form feed. (For another use of the 1 character, see 
Section 7.3,6.) 



STMNT: 



GETSYM 

BEQ 

CMPB 

BEQ 

CMPB 

BEQ 



4$ 

@CHRPNT , # 1 
LABEL 

@CHRPNT,#' = 
AS GMT 



; COLON DELIMITS LABEL FIELD. 

; EQUAL DELIMITS 

; ASSIGNMENT PARAMETER. 



A double quote followed by two characters results in a word 
in which the 7-bit ASCII representations of the two characters are 
placed. For example: 

MOV #" AB,R0 

results in the following word being moved into R0: 

7 9 



15 



8 



102 

T 



octal ASCII value of B 



101 

T 



octal ASCII value of A 



The " character is never followed by a carriage return, null, rub- 
out, line feed or form feed. For example: 



; DEVICE NAME TABLE 
DEVNAM: 

DEVNKB: 



. WORD 


"DF 


•RF DISK 


.WORD 


"DK 


•RK DISK 


.WORD 


"DP 


;RP DISK 


.WORD 


"KB 


• TTY KEYBOARD 


.WORD 


"DT , 


• DECTAPE 


.WORD 


"LP : 


LINE PRINTER 


.WORD 


"PR 


PAPER TAPE READER 


.WORD 


"PP ; 


PAPER TAPE PUNCH 


.WORD 


"CR ; 


CARD READER 


.WORD 


"MT ; 


MAGTAPE 


.WORD 


0 


TABLE'S END 
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6.3.4 .ASCII 



The .ASCII directive translates character strings into their 
7-bit ASCII equivalents for use in the source program. The format 
of the .ASCII directive is as follows: 



.ASCII /character string/ 

where: character string is a string of any acceptable printing ASCII 

characters. The string may not include null 
(blank) characters , rubout, return, line 
feed, vertical tab, or form feed. Nonprinting 
characters can be expressed in digits of the 
current radix and delimited by angle brackets. 
(Any legal, defined expression is allowed be- 
tween angle brackets . ) 

/ / these are delimiting characters and may be 

any printing characters other than ; < and = 
characters and any character within the 
string. 



As an example: 

A: .ASCII /HELLO/ ; STORES ASCII REPRESENTATION OF THE 

; LETTERS H,E,L,L,0 IN CONSECUTIVE BYTES. 

.ASCII /ABC/<15><12>/DEF/ 

; STORES A,B,C, 15, 12 ,D,E,F IN CONSECUTIVE 
; BYTES . 

.ASCII /<AB>/ ;STORES <,A,B,> IN CONSECUTIVE BYTES. 



The ; and = characters are not illegal delimiting characters, but 
are preempted by their significance as a comment indicator and assign- 
ment operator, respectively. For other than the first group, semi- 
colons are treated as beginning a comment field. For example: 



Example 
.ASCII ; ABC ; /DEF/ 



.ASCII 



.ASCII 



/ABC/ ; DEF; 
/ABC/=DEF= 



.ASCII =DEF= 



ASCII string 
Generated 

A B C D E F 



ABC 



A B C D E F 



Notes 

Acceptable, but not recommended 
procedure. 

;DEF; is treated as a comment 
and ignored. 

Acceptable, but not recommended 
procedure. 

The assignment 

.ASCII=DEF 
is performed and a Q error gen- 
erated upon encountering the 
second = . 
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6.3.5 .ASCIZ 



The .ASCIZ directive is equivalent to the .ASCII directive with 
a zero byte automatically inserted as the final character of the 
string. For example: 

When a list or text string has been created with a .ASCIZ 
directive, a search for the null character can determine 
the end of the list. For example: 



MOV # HELLO ,R1 
MOV #LINBUF,R2 
X: MOVB (Rl) +, (R2)+ 

BNE X 

HELLO: .ASCIZ <CR><LF> /MACRO- 11 VJ0J01A/<CR><LF> ; INTRO MESSAGE 



6.3.6 . RAD50 



The . RAD5J0 directive allows the user the capability to handle 
symbols in Radix- 50 coded form (this form is sometimes referred 
to as MOD40 and is used in PDP-11 system programs) . Radix-50 form 
allows three characters to be packed into sixteen bits; therefore, 
any 6-character symbol can be held in two words. The form of the 
directive is: 



. RAD5J2f /string/ 



where: / / delimiters can be any printing characters other 

than the = , < , and ; characters . 

string is a list of the characters to be converted 
(three characters per word) and which may 
consist of the characters A through Z, 0 through 
9, dollar ($) , dot (.) and space ( ). If there 
are fewer than three characters (or if the last 
set is fewer than three characters) they are 
considered to be left justified and trailing 
spaces are assumed. Illegal nonprinting 
characters are replaced with a ? character and 
cause an I error flag to be set. Illegal 
printing characters set the Q error flag. 



The trailing delimiter may be a carriage return, semicolon, or 
matching delimiter. For example: 



. RAD5jZf /ABC ;PACK ABC INTO ONE WORD. 

. RAD 5 0 /AB/ ;PACK AB (SPACE) INTO ONE WORD. 

.RAD5J0 // ;PACK 3 SPACES INTO ONE WORD. 

.RAD 50 /ABCD/ ;PACK ABC INTO FIRST WORD AND 

;D SPACE SPACE INTO SECOND WORD. 
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Each character is translated into its Radix-50 equivalent as indi- 
cated in the following table: 



Character 



Radix-50 Equivalent (octal) 



(space) 
A-Z 
$ 



9 

1-32 
33 
34 
36-47 



0-9 



Note that another character could be defined for code 35, which is 
currently unused. 

The Radix-50 equivalents for characters 1 through 3 (C1,C2,C3) 
are combined as follows: 

Radix 50 value = ( (Cl*50) +C2 ) *50+C3 
For example: 



See Appendix A for a table to quickly determine Radix-50 equi- 
valents. 

Use of angle brackets is encouraged in the .ASCII, .ASCIZ, and 
• RAD50 statements whenever leaving the text string to insert special 
codes. For example: 



. RADSJZf /AB/<35> /STORES 3255 IN NEXT WORD 

CHR1=1 
CHR2=2 
CHR3=3 



.RAD5j2f<CHRl><CHR2><CHR3> ; EQUIVALENT TO . RAD50/ABC/ 



Radix-50 value of ABC is ( (1*50) +2) * 50+3 or 3223 



.ASCII <101> 



; EQUIVALENT TO .ASCII/A/ 
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6.4 RADIX CONTROL 
6.4.1 . RADIX 



Numbers used in a MACRO-11 source program are initially con- 
sidered to be octal numbers. However, the programmer has the 
option of declaring the following radices: 

2, 4, 8, 10 

This is done via the .RADIX directive, of the form: 
.RADIX n 

where: n is one of the acceptable radices. 

The argument to the .RADIX directive is always interpreted in 
decimal radix . Following any radix directive, that radix is the 
assumed base for any number specified until the following .RADIX 
directive. 

The default radix at the start of each program, and the argu- 
ment assumed if none is specified, is 8 (octal). For example: 

.RADIX 10 ; BEGINS SECTION OF CODE WITH DECIMAL RADIX 
.RADIX ; REVERTS TO OCTAL RADIX 

In general it is recommended that macro definitions not con- 
tain or rely on radix settings from the .RADIX directive. The 
temporary radix control characters should be used within a macro 
definition. (+D, +0, and fB are described in the following Sec- 
tion.) A given radix is valid throughout a program until changed. 
Where a possible conflict exists within a macro definition or in 
possible future uses of that code module, it is suggested that the 
user specify values using the temporary radix controls. 

6.4.2 Temporary Radix Control: tD, +0, and fB 

Once the user has specified a radix for a section of code, or 
has determined to use the default octal radix he may discover a 
number of cases where an alternate radix is more convenient 
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(particularly within macro definitions) . For example, the cre- 
ation of a mask word might best be done in the binary radix. 

MACRO- 11 has three unary operators to provide a single 
interpretation in a given radix within another radix as follows: 

+Dx (x is treated as being in decimal radix) 
tOx (x is treated as being in octal radix) 
+Bx (x is treated as being in binary radix) 

For example: 

+D123 
to 47 

+B 00001101 
+0<A+3> 

Notice that while the up arrow and radix specification characters 
may not be separated, the radix operator can be physically separated 
from the number by spaces or tabs for formatting purposes. Where a 
term or expression is to be interpreted in another radix, it should 
be enclosed in angle brackets. 

These numeric quantities may be used any place where a 
numeric value is legal. 

PAL-11R contains a feature, which is maintained for compatibility 
in MACRO- 11, allowing a temporary radix change from octal to decimal 
by specifying a decimal radix number with a "decimal point". For 
example : 

1376. 
128. 



(144 Q ) 
(2540 Q ) 
(2W fl ) 
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6.5 LOCATION COUNTER CONTROL 



The four directives which control movement of the location 
counter are .EVEN and .ODD which move the counter a maximum of one 
byte, and . BLKB and . BLKW which allow the user to specify blocks of 
a given number of bytes or words to be skipped in the assembly. 

6.5.1 .EVEN 

The .EVEN directive ensures that the assembly location counter 
contains an even memory address by adding one if the current ad- 
dress is odd. If the assembly location counter is even, no action 
is taken. Any operands following a .EVEN directive are ignored. 

The .EVEN directive is used as follows: 
.ASCIZ /THIS IS A TEST/ 

. EVEN ;ASSURES NEXT STATEMENT 

; BEGINS ON A WORD BOUNDARY. 

.WORD XYZ 

6.5.2 .ODD 

The .ODD directive ensures that the assembly location counter 
is odd by adding one if it is even. For example: 

;CODE TO MOVE DATA FROM AN INPUT LINE 
;TO A BUFFER 



N=5 ; BUFFER HAS 5 WORDS 
.ODD 

.BYTE N*2 ;COUNT=2N BYTES 

BUFF: .BLKW N ; RESERVE BUFFER OF N WORDS 

MOV #BUFF,R2 ; ADDRESS OF EMPTY BUFFER IN R2 

MOV #LINE,R1 : ADDRESS OF INPUT LINE IS IN Rl 

MOVB -1(R2),R0 ; GET COUNT STORED IN BUFF-1 IN R0 

AGAIN: MOVB (R1)+,(R2)+ ;MOVE BYTE FROM LINE INTO BUFFER 

BEQ DONE ;WAS NULL CHARACTER SEEN? 

DEC RJ2f ; DECREMENT COUNT 

BNE AGAIN ;NOT = 0, GET NEXT CHARACTER 

CLRB -(R2) ;OUT OF ROOM IN BUFFER, CLEAR LAST 

DONE: ;WORD 

LINE: .ASCIZ /TEXT/ 
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In this case, .ODD is used to place the buffer byte count in 
the byte preceding the buffer, as follows: 



COUNT 





















BUFF- 2 
BUFF 



6.5.3 . BLKB and . BLKW 

Blocks of storage can be reserved using the .BLKB and .BLKW 
directives. .BLKB is used to reserve byte blocks and . BLKW reserves 
word blocks. The two directives are of the form: 



.BLKB 
.BLKW 



exp 
exp 



where: exp is the number of bytes or words to reserve. If 

no argument is present, 1 is the assumed default 
value. Any legal expression which is completely 
defined at assembly time and produces an absolute 
number is legal. 



1 



For example: 
000000 1 



3 000000 
A 

000P09 
000006 

000006 

000007 
000010 

10 00012 

11 

12 

13 00020 

14 00024 

15 00026 

16 70026 

17 00030 



PASSl 

SYMBOL I 
MODE I 
FLAGS* 
SFCTORf 
VALUE* 
RFLl VLf 



.CSFCT IVPURF 
.BLKW 



.BLKW 2 

.BLKB 1 

.BLKB i 

.BLKW 1 

.PL** 1 

.RLKfc 2 

.BLKW 2 

.BLKB 1 

.BLKB 1 

.BLKW 1 

CLCMAXl .BLKW 1 



CLCKAMJ 
CLCFGSt 
CLCSEtt 
CLCLOCf 



I NEXT GROUP MUST STAY THGFTHfR 
SYMBOL ACCUMULATOR 

f FL A G BTT5 

IvSYMBOL/EYPPESSICK TYPE 
IFXPRFSSIPK VALUE 

f F NT OF GPOUPFO DATA 

ftURRFKT I 0 T A T I f N COU^TFR SYMBOL 



The .BLKB directive has the same effect as 



.=.+exp 



but is easier to interpret in the context of source code. 
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6.6 NUMERIC CONTROL 



Several directives are available to provide software comple- 
ments to the floating-point hardware on the PDP-11. 

A floating-point number is represented by a string of decimal 
digits. The string (which can be a single digit in length) may 
optionally contain a decimal point, and may be followed by an op- 
tional exponent indicator; in the form of the letter E and a 
signed decimal exponent. The list of number representations below 
contains seven distinct, valid representations of the same floating- 
point number: 

3 

3. 

3.0 

3.0E0 

3E0 

.3E1 

300E-2 

As can be quickly inferred, the list could be extended indef- 
initely (e.g., 3000E-3, .03E2, etc.). A leading plus sign is 
ignored (e.g., +3.0 is considered to be 3.0). Leading minus signs 
complement the sign bit. No other operators are allowed (e.g., 
3.0+N is illegal) . 

Floating-point number representations are only valid in the 
contexts described in the remainder of this Section. 

Floating-point numbers are normally rounded. That is, when a 
floating-point number exceeds the limits of the field in which it 
is to be stored, the high-order excess bit is added to the low-order 
retained bit. For example, if the number were to be stored in a 
2-word field, but more than 32 bits were needed for its value, the 
highest bit carried out of the field would be added to the least 
significant position. In order to enable floating-point truncation, 
the . ENABL FPT directive is used and . DSABL FPT is used to return 
to floating-point rounding (see Section 6.2). 
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6.6.1 . FLT2 and . FLT4 



Like the .WORD directive, the two floating-point storage direc- 
tives cause their arguments to be stored in-line with the source 
program. These two directives are of the form: 



. FLT2 argl , arg2 , . . . 
. FLT4 argl,arg2, . . . 



where : 



argl, arg2 , . . . 



represents one or more floating point 
numbers separated by commas. 



. FLT2 causes two words of storage to be generated for each 
argument while . FLT4 generates four words of storage. 

The following code was assembled with the 4-word floating- 
point math package: 



006010t 


037314 


146314 


146314 


ATOFTB '• ,FLT4 


l.E-1 


Jl0t-1 


006016' 


146315 












006020 i 


036443 


153412 


036560 


1 FLT4 


1,E»2 


J 10t-2 


006026* 


121727 












006030' 


034721 


133427 


054342 


,FLT4 


l.E-M 


; i0t-4 


006036' 


014545 












006040* 


031453 


146167 


010604 


.FLT4 


l.E-8 


; 10t-8 


006046' 


060717 












006050 ' 


022746 


112624 


137304 


.FLT4 


l.E-16 


5l0t-l6 


006056' 


046741 












006060 « 


005517 


130436 


126505 


.FLT4 


l.E-32 


Jl0t-32 


006066 ' 


034625 
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6.6.2 Temporary Numeric Control: and iC 



Like the temporary radix control operators, operators are 
available to specify either a one-word floating-point number 
(tF) or the one's complement of a one-word number (f C) . For 
example : 



FL3.7: + F3.7 



creates a one-word floating-point number at location FL3.7 con- 
taining the value 3.7 as follows: 



15 14 



sign 
bit 



exponent 



7 6 



0 



mantissa 



This one-word floating-point number is the first word of 
the 2- or 4-word floating-point number format shown in the 
PDP-11 Processor Handbook , and the statement: 



CMP151: +C151 



stores the one's complement of 151 in the current: radix (assume current 
radix is octal) as follows: 



15 0 



177626 



Since these control operators are unary operators , their arguments 
may be terms, and the operators may be expressed recursively. For 
example: 



+F<1.2E3> 

+C+D25 or +C31 or 177746 



The term created by the unary operator and its argument is then a 
term which can be used by itself or in an expression. For example: 



+ C2+6 
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is equivalent to: 



<iC2>+6 or 177775+6 or 999992 

For this reason, the use of angle brackets is advised. Expressions 
used as terms, or arguments of a unary operator must be explicitly 
grouped. 

An example of the importance of ordering with respect to unary 
operators is shown below: 



The argument to the iF operator must not be an expression and 
should be of the same format as arguments to the . FLT2 and . FLT4 
directives (see Section 6.6.1). 



+F-1.0 



020400 
120400 



-+F1.0 
-tF-1.0 



157400 
057400 
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6.7 TERMINATING DIRECTIVES 



6.7.1 .END 

The .END directive indicates the physical end of 
the source program. The .END directive is of the form: 

. END exp 

where: exp is an optional argument which, if present , 

indicates the program entry point, i.e., 
the transfer address. 

When the load module is loaded, program execution begins at the 
transfer address indicated by the .END exp directive. In a runtime 
system (the load module output of the Linker) an .END exp statement 
should terminate the first object module and . END statements should 
terminate any other object modules. 

At the conclusion of the first assembly pass, upon encountering 
the END statement, MACRO-11 prints: 

END OF PASS 1 

and attempts to reread the source file(s) to perform pass 2. If 
the source file is on a disk, DECtape, or magtape device no further 
operator action is necessary. If the source file is on paper tape 
an A002 message is printed? the user is expected to reposition the 
tape in the reader and type CO (for CONTINUE) . 

6.7.2 .EOT 

Under the Disk Operating System, the .EOT directive is ignored. 
The physical End- Of -Tape allows several physically separate tapes 
to be assembled as one program. 
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6.8 PROGRAM BOUNDARIES DIRECTIVE: . LIMIT 



A program often wishes to know the boundaries of the load 
module's relocatable code* The .LIMIT directive reserves two 
words into which the Linker puts the low and high addresses of 
the relocated code. The low address (inserted into the first 
word) is the address of the first byte of code. The high ad- 
dress is the address of the first free byte following the relo- 
cated code. These addresses are always even since all reloca- 
table sections are loaded at even addresses. (If a relocatable 
section consists of an odd number of bytes , the Linker adds one 
to the size to make it even.) 
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6.9 PROGRAM SECTION DIRECTIVES 



, ASECT 
.CSECT 

.CSECT symbol 



The Assembler provides for 255^^ program sections: an abso- 
lute section declared by .ASECT, an unnamed relocatable program 
section declared by .CSECT, and 253 1Q named relocatable program 
sections declared by .CSECT symbol, where symbol is any legal 
symbolic name. These directives allow the user to: 



1. Create his program (object module) in sections: 



The Assembler maintains separate location counters 
for each section. This allows the user to write statements 
which are not physically contiguous but will be loaded con- 
tiguously. The following examples will clarify this: 



.CSECT 
A: 0 
B: 0 
C: 0 
ST: CLR A 

CLR B 

CLR C 

.ASECT 

.=4 

.WORD .+2, HALT 
. CSECT 

INC A 
BR ST 
.END 



START THE UNNAMED RELOCATABLE SECTION 
ASSEMBLED AT RELOCATABLE 0, 

RELOCATABLE 2 AND 

RELOCATABLE 4, 
ASSEMBLE CODE AT 

RELOCATABLE ADDRESS 

6 THROUGH 21 
START THE ABSOLUTE SECTION 
ASSEMBLE CODE AT 
ABSOLUTE 4 THROUGH 7, 
RESUME THE UNNAMED RELOCATABLE 

SECTION 
ASSEMBLE CODE AT 

RELOCATABLE 22 THROUGH 27, 



The first appearance of .CSECT or .ASECT assumes the loca- 
tion counter is at relocatable or absolute zero, respect- 
ively. The scope of each directive extends until a directive 
to the contrary is given. Further occurrences of the same 
.CSECT or .ASECT resume assembling where the section was 
left off. 
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.CSECT C0M1 ; DECLARE SECTION COM1 

A: 0 ; ASSEMBLED AT RELOCATABLE 0. 

B: 0 ; ASSEMBLED AT RELOCATABLE 2. 

C: 0 ; ASSEMBLED AT RELOCATABLE 4. 

. CSECT COM2 ; DECLARE SECTION COM2 

X: 0 ; ASSEMBLED AT RELOCATABLE 0. 

Y: 0 ; ASSEMBLED AT RELOCATABLE 2. 

.CSECT COM1 ; RETURN TO COMl 

D: 0 ; ASSEMBLED AT RELOCATABLE 6. 

.END 



The Assembler automatically begins assembling at reloca- 
table zero of the unnamed .CSECT if not instructed other- 
wise; that is, the first statement of an assembly is an 
implied .CSECT. 

All labels in an absolute section are absolute; all 
labels in a relocatable section are relocatable. The 
location counter symbol , " . " , is relocatable or absolute 
when referenced in a relocatable or absolute section, 
respectively. Undefined internal symbols are assigned 
the value of relocatable or absolute zero in a relocatable 
or absolute section, respectively. Any labels appearing 
on a .ASECT or .CSECT statement are assigned the value of 
the location counter before the .ASECT or .CSECT takes 
effect. Thus, if the first statement of a program is: 

A: .ASECT 

then A is assigned to relocatable zero and is associated 
with the unnamed relocatable section (because the Assembler 
implicitly begins assembly in the unnamed relocatable sec- 
tion) . 

Since it is not known at assembly time where the pro- 
gram sections are to be loaded, all references between 
sections in a single assembly are translated by the Assembler 
to references relative to the base of that section. The 
Assembler provides the Linker with the necessary information 
to resolve the linkage. Note that this is not necessary 
when making a reference to an absolute section (the Assembler 
knows all load addresses of an absolute section) . 



6-33 



Examples: 



Y: 
X: 



.ASECT 
.=1000 

CLR X 

JMP Y 

.CSECT 
MOV R(7,R1 
JMP A 
HALT 
0 

. END 



ASSEMBLED AS CLR BASE OF UNNAMED 
RELOCATABLE SECTION + 10 

ASSEMBLED AS JMP BASE OF UNNAMED 
RELOCATABLE SECTION + 6 



; ASSEMBLED AS JMP lpprpr 



In the above example the references to X and Y were 
translated into references relative to the base of the 
unnamed relocatable section. 



2. Share code and/or data between object modules (separate 
assembles) : 



Named relocatable program sections operate as FORTRAN 
labeled COMMON; that is, sections of the same name from 
different assemblies are all loaded at the same location 
by Link-11. The unnamed relocatable section is the ex- 
ception to this as all unnamed relocatable sections are 
loaded in unique areas by Link-11. 

Note that there is no conflict between internal 
symbolic names and program section names; that is, it is 
legal to use the same symbolic name for both purposes. 
In fact, considering FORTRAN again, this is a necessity 
to accommodate the FORTRAN statement : 



COMMON /X/A,B,C,X 



where the symbol X represents the base of this program 
section and also the fourth element of this program 
section. 



Also, there is no conflict between program section 
names and . GLOBL names. In FORTRAN language, COMMON 
block names and SUBROUTINE names may be the same. 
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6.10 SYMBOL CONTROL: .GLOBL 



The Assembler produces a relocatable object module and a 
listing file containing the assembly listing and symbol table. 
Link-11 joins separately assembled object modules into a single 
load module. Object modules are relocated as a function of the 
specified base of the load module. The object modules (where 
there are more than one) are linked via common global symbols , 
such that a global symbol in one module (either defined by 
direct assignment or as a label) can be referenced from another 
module. 

A global symbol must be specified in a .GLOBL directive. 
The form of the .GLOBL directive is: 

. GLOBL syml , sym2 , . . . 

where: syml , sym2 , . . . are legal symbolic names, separated by 

commas or spaces where more than one 
symbol is specified. 

Symbols appearing in a .GLOBL directive are either defined 
within the current program or are external symbols in which case 
they are defined in another program which is to be linked with 
the current program, by Link-11, prior to execution. 

A .GLOBL directive line may contain a label in the label 
field and comments in the comment field. 

At the end of assembly pass 1, MACRO-11 has determined 
whether a given global symbol is defined within the program or 
is expected to be an external symbol. All internal symbols to 
a given program, then, must be defined by the end of pass 1. 



; DEFINE A SUBROUTINE WITH 2 ENTRY POINTS WHICH CALLS AN 
; EXTERNAL SUBROUTINE 





.CSECT 




; DECLARE THE CONTROL SECTION 




. GLOBL 


A,B,C 


; DECLARE A, B, C AS GLOBALS 


A: 


MOV 


@(R5)+,R0 


; ENTRY A DEFINED 




MOV 


#X,R1 




X: 


JSR 


PC,C 


; CALL EXTERNAL SUBROUTINE C 




RTS 


R5 


;EXIT 


B: 


MOV 


@ (R5)+,R1 


; DEFINE ENTRY B 




CLR 


Rl 






BR 


X 
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In the example on the previous page, A and B are entry symbols 
(entry points) , C is an external symbol and X is an internal 
symbol . 

A global symbol is defined only when it appears in a . GLOBL 
directive. A symbol is not considered a global symbol if it is 
assigned the value of a global expression in a direct assignment 
statement . 

References to external symbols can appear in the operand 
field of an instruction or assembler directive in the form of 
a direct reference, i.e.: 

CLR EXT 
. WORD EXT 
CLR @EXT 

or a direct reference plus or minus a constant, i.e.: 
A=6 

CLR EXT+A 
.WORD EXT- 2 
CLR @EXT+A 

An external symbol cannot be used in the evaluation of a direct 
assignment expression. A global symbol defined within the program 
can be used in the evaluation of a direct assignment statement. 
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6.11 CONDITIONAL ASSEMBLY DIRECTIVES 



Conditional assembly directives provide the programmer with 
the capability to conditionally include or ignore blocks of source 
code in the assembly process. This technique is used extensively 
to allow several variations of a program to be generated from the 
source program. 

The general form of a conditional block is as follows: 



.IF cond, argument (s) 
.ENDC 



START CONDITIONAL BLOCK 
RANGE OF CONDITIONAL 
BLOCK 

END CONDITIONAL BLOCK 



where: cond is a condition which must be met if the block 
is to be included in the assembly. These con- 
ditions are defined below. 

argument (s) are a function of the condition to be tested. 



range is the body of code which is included in the 

assembly or ignored depending upon whether 
the condition is met. 



The following are the allowable conditions: 



Conditions 






POSITIVE COMPLEMENT 


ARGUMENTS 


ASSEMBLE BLOCK IF 


EQ NE 


expression 


expression^ (or ^0) 


GT LE 


expression 


express ion>0 (or <0) 


LT GE 


expression 


expression^ (or >0) 


DF NDF 


symbolic 
argument 


symbol is defined 
(or undefined) 


B NB 


macro-type 
argument 


argument is blank 
(or nonblank) 


IDN DIF 


two mar co -type 
arguments separated 
by a comma 


arguments identical 
(or different) 


Z NZ 


expression 


same as EQ/NE 


G L 


expression 


same as GT/LE 




NOTE 




A macro-type argument is enclosed in angle brackets or 
within an up-arrow construction (as described in 
1 Section 7.3.1). For example: 


<A, B,C> 
V124/ 





6-37 



For example: 

.IF EQ ALPHA+1 ; ASSEMBLE IF ALPHA+l=0f 

. ENDC 

Within the conditions DF and NDF the following two operators are 
allowed to group symbolic arguments: 

& logical AND operator 

• logical inclusive OR operator 

For example: 

.IF DF SYM1 & SYM2 
.ENDC 

assembles if both SYM1 and SYM2 are defined. 

6.11.1 Subconditionals 

Subconditionals may be placed within conditional blocks to 
indicate: 

a. assembly of an alternate body of code when the condition of 
the block indicates that the code within the block is not 
to be assembled. 

b. assembly of a non- contiguous body of code within the condi- 
tional block depending upon the result of the conditional 
test to enter the block. 

c. unconditional assembly of a body of code within a condi- 
tional block. 

There are three subconditional directives, as follows: 



Subconditional 


Function 


.IFF 


The code following this statement up to 
the next subconditional or end of the 
conditional block is included in the 
program providing the value of the con- 
dition tested upon entering the condi- 
tional block was false. 


. IFT 


The code following this statement up to 
the next subconditional or end of the 
conditional block is included in the pro- 
gram providing the value of the condition 
tested upon entering the conditional block 
was true . 


. IFTF 


The code following this statement up to 
the next subconditional or the end of the 
conditional block is included in the pro- 
gram regardless of the value of the con- 
dition tested upon entering the condi- 
tional block. 



The implied argument of the subconditionals is the value of the 
condition upon entering the conditional block. Subconditionals are 
used within outer level conditional blocks. Subconditionals are 
ignored within nested, unsatisfied conditional blocks. 
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For example: 



.IF DF SYM ; ASSEMBLE BLOCK IF SYM IS DEFINED 

.IFF 

; ASSEMBLE THE FOLLOWING CODE ONLY IF 
;SYM IS UNDEFINED. 

« 

• IFT ; ASSEMBLE THE FOLLOWING CODE ONLY IF 

;SYM IS DEFINED. 



. IFTF ; ASSEMBLE THE FOLLOWING CODE 

; UNCONDITIONALLY . 



. ENDC 



. IF DF X 


; ASSEMBLY TESTS FALSE 


. IF DF Y 


; TESTS FALSE 


.IFF 


; NESTED CONDITIONAL 




; IGNORED 


.IFT 


;NOT SEEN 


.ENDC 




. ENDC 





However , 



. IF DF X 


; TESTS TRUE 


. IF DF Y 


; TESTS FALSE 


.IFF 
. 


;IS ASSEMBLED 


.IFT 


;NOT ASSEMBLED 


.ENDC 




.ENDC 





6.11.2 Immediate Conditionals 

An immediate condiitonal directive is a means of writing a 
one-line conditional block. In this form, no .ENDC statement is 
required and the condition is completely expressed on the line 
containing the conditional directive. Immediate conditions are 
of the form: 
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.IIF cond, arg, statement 



where: cond is one of the legal conditions defined for 

conditional blocks in Section 6.11. 

arg is the argument associated with the condi- 

tion specified, that is, either an expres- 
sion, symbol, or macro-type argument, as 
described in Section 6.11. 

statement is the statement to be executed if the 
condition is met. 

For example: 

.IIF DF F00 , BEQ ALPHA 
this statement generates the code 

BEQ ALPHA 

if the symbol F00 is defined. 

A label must not be placed in the label field of the .IIF 
statement. Any necessary labels may be placed on the previous 
line : 

LABEL: 

.IIF DF FPP , BEQ ALPHA 

or included as part of the conditional statement: 

.IIF DF F00, LABEL: BEQ ALPHA 

6.11.3 PAL-11R Conditional Assembly Directives 

In order to maintain compatibility with programs developed 
under PAL-11R, the following conditionals remain permissible 
under MACRO-11. It is advisable that future programs be developed 
using the format for MACRO-11 conditional assembly directives. 
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Directive 


Arguments 


Assemble Block if 


.IFZ or . IFEQ 
.IFNZ or . IFNE 
. IFL or . IFLT 
. IFG or . IFGT 
. IFLE 
• IFGE 
. IFDF 
. IFNDF 


expression 
expression 
expression 
expression 
expression 
expression 
logical expression 
logical expression 


expression=0 
expression^ 
expression<j2f 
expression^ 
expression^ 
expression>0 
expression is true (defined) 
expression is false (undefined) 



The rules governing the usage of these directives are now 
the same as for the MACRO-11 conditional assembly directives pre- 
viously described. Conditional assembly blocks must end with 
the . ENDC directive and are limited to a nesting depth of 16 10 
levels (instead of the 127.. n levels allowed under PAL-11R) . 
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CHAPTER 7 
MACRO DIRECTIVES 



7.1 MACRO DEFINITION 



It is often convenient in assembly language programming to 
generate a recurring coding sequence with a single statement. 
In order to do this, the desired coding sequence is first defined 
with dummy arguments as a macro. Once a macro has been defined, 
a single statement calling the macro by name with a list of real 
arguments (replacing the corresponding dummy arguments in the 
definition) generates the correct sequence or expansion. 



7.1.1 .MACRO 



The first statement of a macro definition must be a .MACRO 
directive. The .MACRO directive is of the form: 



. MACRO name, dummy argument list 



where : 



name is the name of the macro. This name is any 

legal symbol. The name chosen may be used as 
a label elsewhere in the program. 

, represents any legal separator (generally a 

comma or space) . 

dummy zero, one, or more legal symbols which may 

argument appear anywhere in the body of the macro 
list definition, even as a label. These symbols 

can be used elsewhere in the user program 
with no conflicts of definition. Where more 
than one dummy argument is used, they are 
separated by any legal separator (generally 
a comma) . 



A comment may follow the dummy argument list in a statement con- 
taining a .MACRO directive. For example: 

.MACRO ABS A,B ; DEFINE MACRO ABS WITH TWO ARGUMENTS 

A label must not appear on a .MACRO statement. Labels are 
sometimes used on macro calls, but serve no function when attached 
to .MACRO statements. 
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7,1.2 . EN DM 



The final statement of every macro definition must be an 
. ENDM directive of the form: 

. ENDM name 



where: 

name is an optional argument, being the name of the 

macro terminated by the statement. 

For example: 

.ENDM (terminates the current macro definition) 

.ENDM ABS (terminates the definition of the macro ABS ) 

If specified, the symbolic name in the .ENDM statement must 
correspond to that in the matching .MACRO statement. Otherwise 
the statement is flagged and processing continues. Specification 
of the macro name in the .ENDM statement permits the Assembler to 
detect missing .ENDM statements or improperly nested macro defini- 
tions . 

The ENDM statement may contain a comment field, but must not 
contain a label. 

An example of a macro definition is shown below: 

.MACRO TYPMSG MESSGE ; TYPE A MESSAGE 
JSR R5, TYPMSG 
.WORD MESSGE 
. ENDM 



7.1.3 .MEXIT 

In order to implement alternate exit points from a macro 
(particularly nested macros) , the .MEXIT directive is provided. 
.MEXIT terminates the current macro as though an .ENDM directive 
were encountered. Use of . MEXIT bypasses the complications of 
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conditional nesting and alternate paths. For example: 



.MACRO ALTR N,A,B 



.IF 



EQ,N 



; START CONDITIONAL BLOCK 



.MEXIT 
.ENDC 



;EXIT FROM MACRO DURING CONDITIONAL BLOCK 
; END CONDITIONAL BLOCK 



.ENDM 



; NORMAL END OF MACRO 



In an assembly where N=0, the .MEXIT directive terminates the macro 
expansion. 

Where macros are nested, a .MEXIT causes an exit to the next 
higher level. A .MEXIT encountered outside a macro definition is 
flagged as an error. 

7.1.4 MACRO Definition Formatting 

A form feed character used as a line terminator on a MACRO-11 
source statement, (or as the only character on a line) causes a 
page eject. Used within a macro definition, a form feed character 
causes a page eject. A page eject is not performed when the macro 
is invoked. 

Used within a macro definition, the .PAGE directive is ignored, 
but a page eject is performed at invocation of that macro. 

7.2 MACRO CALLS 

A macro must be defined prior to its first reference. Macro 
calls are of the general form: 



label: name, real arguments 



where: 



name 



label 



represents an optional statement label. 

represents the name of the macro specified 
in the .MACRO directive preceding the macro 
definition. 
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represents any legal separator (comma, 
space , or tab) . No separator is necessary 
where there are no real arguments. 

real are those symbols, expressions, and values 

arguments which replace the dummy arguments in the 
.MACRO statement. Where more than one 
argument is used, they are separated by 
any legal separator. 

Where a macro name is the same as a user label, the appearance of 
the symbol in the operation field designates a macro call, and the 
occurrence of the symbol in the operand field designates a label 
reference. For example: 

ABS: MOV @R0,R1 ;ABS IS USED AS LABEL 

BR ABS ;ABS IS CONSIDERED A LABEL 

ABS # 4 , ENT r LAR ; CALL MACRO ABS WITH 3 ARGUMENTS 

Arguments to the macro call are treated as character strings whose 
usage is determined by the macro definition. 

7.3 ARGUMENTS TO MACRO CALLS AND DEFINITIONS 

Arguments within a macro definition or macro call are separated 
from other arguments by any of the separating characters described 
in Section 3.1.1. 

For example: 

.MACRO REN A,B,C 

REN ALPHA , BETA , <C1 , C2 > 

Arguments which contain separating characters are enclosed in paired 
angle brackets. An up-arrow construction is provided to allow 
angle brackets to be passed as arguments. Bracketed arguments are 
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seldom used in a macro definition , but are more likely in a 
macro call. For example: 

REN <MOV X,Y>#44,WEV 

This call would cause the entire statement: 

MOV X,Y 

to replace all occurrences of the symbol A in the macro definition. 
Real arguments within a macro call are considered to be character 
strings and are treated as a single entity until their use in the 
macro expansion. 

The up-arrow construction could have been used in the above 
macro call as follows: 

REN t/MOV X,Y/,#44,WEV 

which is equivalent to: 

REN <MOV X,Y>,#44,WEV 

Since spaces are ignored preceding an argument, they can be used 
to increase legibility of bracketed constructions. 

The form: 

REN #44,WEVVMOV X,Y/ 

however, contains only two arguments: #44 and WEV f/MOV X,Y/ (see 
section 3.1.1) because I is a unary operator. 



7.3.1 Macro Nesting 

Macro nesting (nested macro calls) , where the expansion of one 
macro includes a call to another macro, causes one set of angle brackets 
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to be removed from an argument with each nesting level. The depth of 
nesting allowed is dependent upon the amount of core space used by 
the program. To pass an argument containing legal argument delimiters 
to nested macros, the argument should be enclosed in one set of angle 
brackets for each level of nesting, as shown below: 



. MACRO LEVEL1 DUM1 , DUM2 
LEVEL 2 DUM1 
LEVEL 2 DUM2 
. ENDM 

.MACRO LEVEL 2 DUM3 
DUM3 

ADD #10, R0 
MOV R0, (Rl)+ 
.ENDM 



A call to the LEVELl macro: 



LEVEL 1 <<MOV X,RJ2f>>,<<CLR R0>> 



causes the following expansion: 



MOV X,R0 
ADD #10,R0 
MOV RJ0, (Rl) + 
CLR R0 
ADD #10,R0 
MOV R0, (Rl)+ 



where macro definitions are nested (that is, a macro definition is 
entirely contained within the definition of another macro) the inner 
definition is not defined as a callable macro until the outer macro 
has been called and expanded. For example: 



.MACRO LV1 A, B 



.MACRO LV2 A 



.ENDM 
.ENDM 



The LV2 macro cannot be called by name until after the first call 
to the LV1 macro. Likewise, any macro defined within the LV2 macro 
definition cannot be referenced directly until LV2 has been called. 
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7.3.2 Special Characters 



Arguments may include special characters without enclosing 
the argument in a bracket construction if that argument does not 
contain spaces, tabs, semi-colons, or commas. For example: 

.MACRO PUSH ARG 
MOV ARG,-(SP) 
. ENDM 



PUSH X+3(%2) 



generates the following code: 



MOV X+3 (%2) ,- (SP) 



7.3.3 Numeric Arguments Passed as Symbols 

When passing macro arguments, a useful capability is to pass 
a symbol which can be treated by the macro as a numeric string. 
An argument preceded by the unary operator backslash (\) is treated 
as a number in the current radix. The ASCII characters represent- 
ing the number are inserted in the macro expansion; their function 
is defined in context. For example: 

B=0 

.MACRO INC A, B 
CNT A, SB 
B=B+1 

.ENDM 

.MACRO CNT A, B 
A ' B : . WORD 
.ENDM 



INC X,C 



The macro call would expand to: 



X0: .WORD 



A subsequent identical call to the same macro would generate: 



XI: .WORD 
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and so on for later calls. The two macros are necessary because 
the dummy value of B cannot be updated in the CNT macro. In the 
CNT macro, the number passed is treated as a string argument. 
(Where the value of the real argument is 0, a single 0 character 
is passed to the macro expansion.) 

The number being passed can also be used to make source 
listings somewhat clearer. For example , versions of programs 
created through conditional assembly of a single source can 
identify themselves as follows: 

.MACRO IDT SYM ; ASSUME THAT THE SYMBOL ID TAKES 

. I DENT /SYM/ ;0N A UNIQUE 2 DIGIT VALUE FOR 

. ENDM ; EACH POSSIBLE CONDITIONAL ASSEMBLY 

.MACRO OUT ARG ; OF THE PROGRAM 

IDT 005 A 1 ARG 

. ENDM 



; WHERE 005A IS THE UPDATE 
OUT \ID ; VERSION OF THE PROGRAM 

; AND ARG INDICATES THE 
; CONDITIONAL ASSEMBLY VERSION. 



The above macro call expands to 



.IDENT /005AXX/ 



where XX is the conditional value of ID. 



Two macros are necessary since the text delimiting characters in 
the .IDENT statement would inhibit the concatenation of a dummy 
argument. 



7.3.4 Number of Arguments 



If more arguments appear in the macro call than in the macro 
definition, the excess arguments are ignored. If fewer arguments 
appear in the macro call than in the definition, missing arguments 
are assumed to be null (consist of no characters) . The conditional 
directives . IFB and . IFNB can be used within the macro to detect 
unnecessary arguments. 



A macro can be defined with no arguments. 
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7.3.5 Automatically Created Symbols 



MACRO-11 can be made to create symbols of the form n$ where 
n is a decimal integer number such that 64<n£l27. Created symbols 
are always local symbols between 64$ and 127$. (For a description 
of local symbols, see Section 3.5.) Such local symbols are created 
by the Assembler in numerical order, i.e.: 



64$ 
65$ 



126$ 
127$ 



Created symbols are particularly useful where a label is required 
in the expanded macro. Such a label must otherwise be explicitly^ 
stated as an argument with each macro call or the same label is 
generated with each expansion (resulting in a multiply-defined 
label) . Unless a label is referenced from outside the macro, 
there is no reason for the programmer to be concerned with that label. 



The range of these local symbols extends between two explicit 
labels. Each new explicit label causes a new local symbol block 
to be initialized. 

The macro processor creates a local symbol on each call of a 
macro whose definition contains a dummy argument preceded by the ? 
character. For example: 



.MACRO ALPHA A,?B 

TST A 

BEQ B 

ADD #5, A 

B: 

• ENDM 



Local symbols are generated only where the real argument of the 
macro call is either null or missing. If a real argument is 
specified in the macro call, the generation of a local symbol is 
inhibited and normal replacement is performed. Consider the fol- 
lowing expansions of the macro ALPHA above. 
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GENERATE A LOCAL SYMBOL FOR MISSING ARGUMENT: 



ALPHA %1 
TST %1 
BEQ 64$ 
ADD #5,%1 

64$: 

DO NOT GENERATE A LOCAL SYMBOL: 



ALPHA %2,XYZ 
TST %2 
BEQ XYZ 
ADD #5,%2 

XYZ : 



These Assembler-generated symbols are restricted to the first 
sixteen (decimal) arguments of a macro definition. 

7.3.6 Concatenation 



The apostrophe or single quote character ( 1 ) operates as a 
legal separating character in macro definitions. An ' character 
which precedes and/or follows a dummy argument in a macro defini- 
tion is removed and the substitution of the real argument occurs 
at that point. For example: 



.MACRO DEF A, B , C 
A'B: .ASCIZ /C/ 

.WORD 1 f A f * 'B 
. ENDM 



When this macro is called: 

DEF X,Y, <MACR0-11> 
it expands as follows: 



XY: .ASCIZ /MACRO- 11/ 
.WORD f X*Y 



In the macro definition, the scan terminates upon finding the 
first 1 character. Since A is a dummy argument, the 1 is removed. 
The scan resumes with B, notes B as another dummy argument and 
concatenates the two dummy arguments. The third dummy argument is 
noted as going into the operand of the .ASCIZ directive. On the 
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next line (this is not a useful example, but one for purely il- 
lustrative purposes) the argument to .WORD is seen as follows: 
The scan begins with a 1 character. Since it is neither preceded 
nor followed by a dummy argument, the 1 character remains in the 
macro definition. The scan then encounters the second 1 charac- 
ter which is followed by a dummy argument and is discarded. The 
scan of the argument A terminated upon encountering the second 1 
which is also discarded since it follows a dummy argument. The 
next 1 character is neither preceded nor followed by a dummy 
argument and remains in the macro expansion. The last 1 charac- 
ter is followed by another dummy argument and is discarded. 
(Note that the five 1 characters were necessary to generate two 
1 characters in the macro expansion.) 

Within nested macro definitions, multiple single quotes can 
be used, with one quote removed at each level of macro nesting. 

7.4 . NARG , . NCHR, AND .NTYPE 

These three directives allow the user to obtain the number of 
arguments in a macro call (.NARG), the number of characters in an 
argument (.NCHR), or the addressing mode of an argument (.NTYPE). 
Use of these directives permits selective modifications of a macro 
depending upon the nature of the arguments passed. 

The .NARG directive enables the macro being expanded to 
determine the number of arguments supplied in the macro call, 
and is of the form: 



label : 



NARG 



symbol 



where : 



label 



is an optional statement label 



symbol 



is any legal symbol whose value is equated 
to the number of arguments in the macro call 
currently being expanded. The symbol can be 
used by itself or in expressions. 



This directive can occur only within a macro definition. 
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The . NCHR directive enables a program to determine the 
number of characters in a character string, and is of the form: 



label: • NCHR symbol , <character string> 



where: 



label 



is an optional statement label 



symbol 



<character string> 



is any legal symbol which is equated to the 
number of characters in the specified char- 
acter string. The symbol is separated from 
the character string argument by any legal 
separator. 

is a string of printing characters which should 
only be enclosed in angle brackets if it con- 
tains a legal separator. A semi-colon also 
terminates the character string. 



This directive can occur anywhere in a MACRO- 11 program. 



The .NTYPE directive enables the macro being expanded to 
determine the addressing mode of any argument, and is of the 
form: 

label: .NTYPE symbol, arg 

where: label is an optional statement label 

symbol is any legal symbol, the low order 6-bits 

of which is equated to the 6-bit addressing 
mode of the argument. The symbol is separ- 
ated from the argument by a legal separator. 
This symbol can be used by itself or in ex- 
pressions. 

arg is any legal macro argument (dummy argument) 

as defined in Section 7.3. 



This directive can occur only within a macro definition. An 
example of . NTYPE usage in a macro definition is shown below: 



.MACRO SAVE ARG 
.NTYPE SYM, ARG 
•IF EQ,SYM&7# 
MOV ARG, TEMP 
.IFF 

MOV #ARG , TEMP 
. ENDC 
. ENDM 



; REGISTER MODE 

; NON-REGISTER MODE 
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7.5 . ERROR and • PRINT 



The . ERROR directive is used to output messages to the command 
output device during assembly pass 2. A common use is to provide 
diagnostic announcements of a rejected or erroneous macro call. The 
form of the .ERROR directive is as follows: 



where : 



label : 

label 
expr 



text 



. ERROR expr ; t ex t 

is an optional statement label 

is an optional legal expression whose value 
is output to the command device when the 
.ERROR directive is encountered. Where 
expr is not specified, the text only is 
output to the command device. 

denotes the beginning of the text string 
to be output. 

is the string to be output to the command 
device. The text string is terminated by 
a line terminator. 



Upon encountering a .ERROR directive anywhere in a MACRO-11 program , 
the Assembler outputs a single line containing: 



a. the sequence number of the .ERROR directive line, 

b. the current value of the location counter, 

c. the value of the expression if one is specified, and, 

d. the text string specified. 

For example: 

.ERROR A; UNACCEPTABLE MACRO ARGUMENT 
causes a line similar to the following to be output: 

512 5642 000076 ; UNACCEPTABLE MACRO ARGUMENT 



This message is being used to indicate an inability of the subject 
macro to cope with the argument A which is detected as being indexed 
deferred addressing mode (mode 70) with the stack pointer (%6) used 
as the index register. 

The line is flagged on the assembly listing with a P error code. 

The .PRINT directive is identical to .ERROR except that it is 
not flagged with a P error code. 
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7.6 INDEFINITE REPEAT BLOCK: . IRP AND .IRPC 



An indefinite repeat block is a structure very similar to 
a macro definition. An indefinite repeat is essentially a macro 
definition which has only one dummy argument and is expanded once 
for every real argument supplied. An indefinite repeat block is 
coded in-line with its expansion rather than being referenced by 
name as a macro is referenced. An indefinite repeat block is of 
the form: 



label: .IRP arg,<real argument s> 

(range of the indefinite repeat) 
- EN DM 



where: label is an optional statement label. A label may 

not appear on any .IRP statement within an- 
other macro definition, repeat range or indef- 
inite repeat range, or on any . ENDM statement. 

arg is a dummy argument which is successively 

replaced with the real arguments in the 
.IRP statement. 



<real argument> is a list of arguments to be used in the ex- 
pansion of the indefinite repeat range and 
enclosed in angle-brackets. Each real argu- 
ment is a string of zero or more characters 
or a list of real arguments (enclosed in 
angle brackets) . The real arguments are 
separated by commas. 

range is the block of code to be repeated once for 
each real argument in the list. The range 
may contain macro definitions, repeat ranges, 
or other indefinite repeat ranges. Note that 
only created symbols should be used as labels 
within an indefinite repeat range. 



An indefinite repeat block can occur either within or outside 
macro definitions, repeat ranges, or indefinite repeat ranges. 
The rules for creating an indefinite repeat block are the same 
as for the creation of a macro definition (for example, the .MEXIT 
statement is allowed in an indefinite repeat block) . Indefinite 
repeat arguments follow the same rules as macro arguments. 
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1 

2 
3 

4 000000 

000*30i 

00^002 

000003 
000004 
00000t> 

00000a 

000007 
000006 
000007 

177S70 

5 000000 012/00 

000056' 

6 
7 
6 
9 

10 
U 

00004 016720 

000032 



.TITLE 
• UIST 
t MC ALL 
•PARAM 

R0»%AQ0 
Rl*%AQi 

R2«%A02 
H3«%A03 
R4*%AU4 
R5*%AQ5 

R7*%AQ7 

PC*%AQ7 
PSW«A0177776 
SWKaiAOi77570 



lRPT^T 
'HOi Mt, ME 
,PARAM 



■ XKP 

• ENOH 
MOV 



#TABL£# R0 
X,<AfB,C#QfE,F> 

A, (R0J ♦ 



00010 016720 
000030 



HOV 



a, CRM).* 



00014 016720 
000026 



HOV 



00028 016720 
000024 



MOV 



D* CR0) + 



00024 016?2# 
000022 



nav 



Ei CR0)+ 



00030 0it>720 
000020 



MOV 



Fi (KB}* 



Figure 7-1 



t IRP and . IRPC Example 
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•ISPC X,A8CDEF 



15 .ASCII /*/ 

16 

17 .fc>OM 











.ASCII 


/A/ 






1^2 




•ASCII 


/B / 




yj Wi v v v 


1 




. ASCII 


/C/ 










A w r T T 


/ r i / 




r/i 

16 fe3 ** 


A ^ >? 




* A OU 1 I 


f \mf 










•ASCII 


/p / 


18 












19 












20 




V4H^l 


At 




"A* 


21 


00fc44 




01 


, twQRp 




22 




W42lto3 


CJ 


• *U*0 


"CU 


2d 


0 0 ^ t> 


K42&i/.4 


D! 


• *ORQ 


»UE 


24 




to 4 0 i 0 b 


ts 


• *OSQ 


n t p 


23 


i«4 </) ^ S -a 




P t 


• *LRtf 


" KG 


26 






TABLE* 


• BL** 


6 


27 












28 








• 6 N 0 





Figure 7-1, Continued 
.IRP and . IRPC Example 
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A second type of indefinite repeat block is available which 
handles character substitution rather than argument substitution. 
The .IRPC directive is used as follows: 



On each iteration of the indefinite repeat range, the dummy argu- 
ment (arg) assumes the value of each successive character in the 
string. Terminators for the string are: space, comma, tab, 
carriage return, line feed, and semi-colon. 

7.7 REPEAT BLOCK: .REPT 

Occasionally it is useful to duplicate a block of code a 
number of times in line with other source code. This is per- 
formed by creating a repeat block of the form: 



label: 



.IRPC arg, string 



(range of indefinite repeat) 



. ENDM 



label: 



.REPT 



expr 



(range of repeat block) 



. ENDM 



;0R 



. ENDR 



where : 



label 



is an optional statement label. The .ENDR or 
.ENDM directive may not have a label. A .REPT 
statement occurring within another repeat block, 
indefinite repeat block, or macro definition may 
not have a label associated with it. 



expr 



is any legal expression controlling the number of 
times the block of code is assembled. Where 
expr<J2f, the range of the repeat block is not 
assembled. 



range 



is the block of code to be repeated expr number 
of times. The range may contain macro definitions, 
indefinite repeat ranges, or other repeat ranges. 
Note that no statements within a repeat range can 
have a label. 
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The last statement in a repeat block can be an . EN DM or . ENDR 
statement. The .ENDR statement is provided for compatibility 
with previous assemblers. 

The .MEXIT statement is also legal within the range of a 
repeat block. 



7. 8 MACRO LIBRARIES: . MCALL 

All macro definitions must occur prior to their referencing 
within the user program. MACRO-11 provides a selection mechanism 
for the programmer to indicate in advance those system macro defini- 
tions required by his program. 

The .MCALL directive is used to specify the names of all system 
macro definitions not defined in the current program but required 
by the program. The .MCALL directive must appear before the first 
occurrence of a macro call for an externally defined macro. The 
.MCALL directive is of the form: 

.MCALL argl,arg2, . . . 

where argl , arg2 , . . . are the names of the macro definitions 

required in the current program. 

When this directive is encountered, MACRO-11 searches the system 
library files to find the requested definition (s ) . The system library 
file, SYSMAC.SML, is first sought under the current user's UIC on the 
system device where, if found, the Assembler takes the definition for 
all requested macros. If all macro requests have not been satisfied, 
or if SYSMAC.SML does not exist under the current UIC, the Assembler 
searches for the file SYSMAC;SML under [1,1] on the system device. 

See Appendix D for a listing of the system macro file (SYSMAC.SML) 
stored under [1,1] on the system device. 
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CHAPTER 8 
OPERATING PROCEDURES 

The MACRO-11 Assembler assembles one or more ASCII source files 
containing MACRO-11 statements into a single relocatable binary 
object file. The output of the Assembler consists of a binary object 
file and an assembly listing followed by the symbol table listing. 
A CREF (cross reference) listing can be specified as part of the 
assembly output by means of a switch option. 

8.1 LOADING MACRO-11 

MACRO-11 is loaded with the Disk Monitor RUN command as follows: 
$_RUN MACRO 

(Characters printed by the system are underlined to differentiate 
them from characters typed by the user.) The Assembler responds 
by identifying itself and its version number, followed by a # char- 
acter to indicate readiness to accept a command input string: 

MACRO VJ301A 

i 

8.2 COMMAND INPUT STRING 

In response to the # printed by the Assembler, the user types 
the output file specif ication (s) , followed by a left angle bracket, 
followed by the input file specif ication (s) : 

#ob j ect , listing <sourcel , source2 , . . . , sourceN 

where: object is the binary object file 

listing is the assembly listing file containing the assembly 
listing and symbol table and, optionally, a separate 
CREF listing file can be appended to the assembly 
listing or output as a separate file. 

sourcel,source2, are the ASCII source files containing the 
. .., sourceN MACRO-11 source program (s ) . No limit is 

set on the number of source input files, 
except as the Assembler is limited by the 
size of the user-defined and macro symbol 
tables . 
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If an error is made in typing the command string, typing the 
RUBOUT key erases the immediately preceding character. Repeated 
typing of the RUBOUT key erases one character for each RUBOUT up 
to the beginning of the line. Typing CTRL/U erases the entire 
line. 



A null specification in any of the file fields signifies 
that the associated input or output file is not desired. Each 
file specification contains the following information (and follows 
the standard DOS conventions for file specifications) : 



dev : f ilenam . ext [uic ] /option : arg 



One or more switch options can be specified with each file speci- 
fication to provide the Assembler with information about that file. 
The switch options are described in Section 8.3. 

A syntactical error detected in the command string causes the 
Assembler to output the command string up to and including the 
point where the error was detected, followed by a ? character. 
The Assembler then reprints the # character and waits for a new 
command string to be entered. The following command string semanti- 
cal errors are detected: 



Error 



Error Code 



Illegal switch 
Too many switches 
Illegal switch value 
Too many switch values 

Too many output file specifications 
Input file missing 



S203 



S204 
S206 



The default value for each file specification is noted below: 



object 



listing 



sourcel 



dev 

system 
device 

device used 
for object 
output 



CREF system 
intermediate device 



system 
device 



f ilnam 

last source 
file name 

last source 
file name 



last source 
file name 



ext 
. OBJ 

. LST 

.CRF 

.MAC 
.PAL 
.null 



uic 
current 

current 
current 
current 
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dev 



f ilnam 



source2 

sourceN 

system 

macro 

file 



device used 
for sourcel 
(last source 
file specified) 

system device SYSMAC 



ext 

.MAC 
. PAL 
. null 



• SML 



uic 

current 



current 
[1,1] 



8.3 SWITCH OPTIONS 

There are four types of switch options: listing options, func- 
tions, CREF specifications, and pass assembly controls. The listing 
options are described in detail in Section 6.1.1. The function options 
are described in detail in Section 6.2. Rather than repeat this in- 
formation here, the reader is advised to turn to these sections or the 
summary contained in Appendix B. The switch options are specified in 
the form: 

Specification Function 



/LI ^ 

/NL-^ } Listing control 

/NL:arg J 

/Ds!arg } Function Control 

/CRF ^ Produce cross reference table 

/CRF ; arg / 



/PA:1 Assemble file during Pass 1 only 

/PA: 2 Assemble file during Pass 2 only 

Switch options specified on the output side apply to both the 
object and listing files. Switch options specified on the input 
side apply to the particular file which the switch follows and all 
subsequent files. 



8.4 CREF, CROSS-REFERENCE TABLE GENERATION 



A cross reference listing of all or a subset of all symbols used 
in the source program can be obtained by a call to the CREF routine. 
CREF can be used in two ways: 

a. CREF can be called automatically following an assembly. 
In order to do this, the /CRF switch is specified fol- 
lowing the assembly listing file specification. For 
example : 

#_, LP : /CRF<FILE1 , FILE2 

This command string sends the assembly listing (FILE2.LST) 
to the line printer. An intermediate CREF file is created 
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and temporarily stored on the system device 
(FILE2.CRF) under the current UIC. The CREF 
routine takes this intermediate file, generates 
a CREF listing and routes that listing to the 
line printer. (The CREF listing is appended 
to the file FILE2.LST.) The CREF intermediate 
file is then deleted; there is no way to pre- 
serve this file when CREF is being called auto- 
matically . 

b. If no CREF listing is desired immediately , the 
intermediate CREF file can be saved on the sys- 
tem device; and the CREF listing can be gener- 
ated at a later date. In order to preserve the 
intermediate CREF file, the MACRO command string 
is given as follows: 

#_, LP : /CRF : NG<FILE1 , FILE2 

This command string sends the assembly listing 
(FILE2.LST) to the line printer. The CREF in- 
termediate file (FILE2.CRF) is sent to the 
system device under the current UIC. (The :NG 
argument is a mnemonic for "No Go" to CREF; 
i.e., no automatic transfer to the CREF rou- 
tine following the output of the assembly 
listing. ) 

In order to generate the CREF listing, the 
CREF routine is run and given a command string 
indicating the input file specif ication (s) and 
a single output file specification. For 
example : 

_$RU CREF 
CREF V0£1A 
#LP: <FILE2.CRF 

In this case the intermediate file created 
automatically in the example above is pro- 
cessed to obtain a CREF listing which is then 
sent to the line printer. The CREF inter- 
mediate file is then automatically deleted. 
If it is desired to preserve the intermediate 
file, the command string should be given as: 

#LP:<FILE2 .CRF/SA 

Unless the /SA switch is specified, the default 
case is always to delete the CREF intermediate 
file. 



The CREF listing is organized into one to five sections, each 
listing a different type of symbol. The sections are as follows: 



Section Type 



Argument 
:S 



user-defined symbols 
macro symbolic names 



:M 



permanent symbols (instructions, 



directives) 



:P 
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Section Type 
.CSECT symbolic names 
error codes 



Argument 
:C 
:E 



Where no arguments are specified following the /CRF switch, all 
of the above sections except the permanent symbols are cross refer- 
enced. However, when any one argument is specified (other than :NG) , 
no other default sections are assumed or provided. For example, in 
order to obtain a CREF listing for all five section types, the fol- 
lowing switch option specification is used: 

/CRF:S:M:P:C:E 

The order in which the arguments are specified does not affect the 
order of their output, which is as listed above. 

Figure 8-1 contains a segment of source code and Figure 8-2 
contains a segment of a CREF listing with some references to the 
code in Figure 8-1. Notice the appearance of the @ and # characters 
in the CREF listing. An @ character appears in the CREF listing 
wherever a destructive reference has been made to that symbol (i.e., 
the contents of that symbol have been altered at that point) . A # 
character appears in the CREF listing wherever a symbol is defined. 



8-5 



HACf*U V001 l7*APR-72 
UBjECT CUOt HANDLERS 



MACRO VE0I3A1 17-APR-72 19509 PAGE 72 



i 

m 

0 






OBJECT CODE 


HANDLERS 


c 








f EMO OF PASS HANDLER 


4 u) 1 2026 




CALL 


SETMAX 




1 '> w 2 6 

M i ft f 6 V T 




J Sft 

w *■# n 


PC | SETHAX 






174240 








W (C I ft Y> W C 


i/ *> 7 <S 7 




PASS 


J PASS ONE? 




tjk {A f% iA (A iA f 










flirt 1 1 42 

t' W ill k ^ ft 




ENUP2 


f BRANCH IF PASS 2 


f W A ft t? ■» r ' 






4 




M <y* 1 O l> A Q\ 

v 10 1 m ** • »v 


i/*i/t S767 


rsr 


QBJLNK 


IPASS ONE, ANY OBJECT? 




{71 i/l 1 4 1 A f 








y Ml 21? 44 


Aft i *i 1 7 




30$ 


1 NO 


1 51 1 2046 


0 12767 




«BLKrfll, 6LKTYP MET BLOCK TYP1 1 




«» W *' V t' A 










(?) ft i 4 2 f 
v 1 *• ft 








1 1 1 2 l^h4 

A X 1 ft v v •* 






0 H J T M T 


iTmtt rue pnTKiTFRS 


1 2 ft 3 4 


ft i/l 4 7fi 7 


W v? T 


PC . HA T T N T 






fld 1 342 

- ' V A v ft 








1 2 \'J!AhV 
A C iiwWt 


M 1 27 ft 1 


M 0 V 




IS£T "FROM" TNOF)( 




01 ivi d i/i S i/ f 
r> IQ l! v v u 








1 3 1 2GI ft 4 

1W 1 ft - ' V ** 


C1 1 ft 7 01 2 

t? 1 Vf V» ft 




KLDPNT, R2 


1 ANO "TO" INDEX 




$ 14 # 3 4tf ' 








14 120/P 1 




CALL 


GSUO-iP 


; OUTPUT GSD BLOCK 




004 7 67 


J $rt 


PCrGSOQMP 






T' XJ * 1 V V 








15 12874 


&M5046 

%r W 


CtK 


-C^P) 


tlHlT FOR SECTOR SCAN 


16 1207* 


012667 lflj*8 


fl0 ^ 


(SRJ *,*QLwP0 


J SET SCAN MARKER 




1 - w T * %J %.» \J 








17 1 2 1 u2 






SECROL 


|G£T THE NEXT SECTOR 


12102 


^12700 




»SEC^0L^« 






5^0^01 0 








121^6 


004/67 


j Sk 


PC,N£XT 






0054^)0 

v v ~ r %- 








i 8 12112 


ft" 1 ^ so 


6Eu 


2«$ 


1 BRANCH IF THROUGH 


1 9 12114 


016/46 


.10 V 


KOLUPD, -CSP) 


^ SAVE MARKER 




v ' W * ' %J Wt W 








ft tfl A ft A ft K' 


(?» 1 27 1 

¥ A ft / 4 


new 


«M00E,«1 






(51 ;4 fJl £J1 (?i M 1 
O rl ijji D 










Ot 1 1 1 31 n 
^ 1 1 1 "0 


M fl U 


CR1) #R5 


;save SECTOR 


ft «. 1 < I ft" 


^ 4 9 7 t/l S 
W M ft r «rr »3 




#377, RS 


HSQLATE IT 




W id »i 7 7 

4} V Y> V f T 










i0 v 0 V 


i> ^» A D 


R^ 


i ANO PLACE IN RIGHT 




V} H ft / A A 




#*l-<R£LFL(i> 


, CR1) ICLEAR ALL BUT 




1 7 7 7^7 

If f r o f 








25 12 14ft 

ft v + ft 1 ?- 


l»k272 1 

» ' M ft ' ft A 


6 I S 


»<bSaT01>*DEFFLG f CR1) t J SET TO TYPE 1 




flijlMl k3 








26 12144 


WJL0321 




R5, CR1)+ 


MSSUME ABS 


27 12146 


^01401 


aey 


1 1% 


; 00P31 


26 12150 


01U41 


MOV 


CRD 


; R£L, SET MAX 


29 12102 


^05067 11*8 


CLH 


ROLUPO 


;SET POR INNER SCAN 












33 121&6 


5^12/01 X?S I 


dOV 


«SYM60Lf ^1 






5900002* 








31 12162 




CALL 


(iSPDHP 


| OUTPUT THIS BLOCK 


1216? 


304/67 




PC,(iS0t)MP 






0*00666 









Figure 8-1 
Assembly Listing 
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oh jsut Cuut handlers 



HACRg 17-APR-72 19109 PAGE 72* 



32 12166 
12166 

121/2 

33 121/6 

34 12200 



35 122*36 

36 122 IP 

37 12214 
3$ 122*6 



39 1*224 



40 12232 



012/00 

004/67 

301737 
032/6/ 

04176/ 
12«7*S 

^1364 
042/67 
1/7*2/ 

052767 

tftf2:4 f 40 
0*3*731 



1341 



>xext 
nay 

JSR 
dEii 



3IC 



013 



&YHR0L 

PC, NEXT 
10S 

*6LBFLG , HOPE 



13$ 

SECTOR, R3 
13$ 



f FETCH THE NEXT SYMBOL 



? FINISHED WITH THIS GUY 
f GLOBAL? 



9 NO 

JY£S, PROPER SECTOR? 
I NO 



*M-<DeFFLeiRELFLGlfiLBPLQ>fMODE ? CLEAR HOST 



*GSOT04,tfODE J$£T TYPE 4 



12$ 



fOUTPUT IT 



Figure 8-1 (Cont. ) Assembly Listing 



£NU-1aC 


27-4-4 


109-3^** 














23-23 


72- 3* 












tNJPiM 


73-16 


73-22** 












ENu?2 
• 
• 


72* 6 


74- 1* 












• 

N 0 F F L G 


12- 7 4 


3^-26 


92- 8 


92-24 








nExir 


lib- 14 


11*-41* 












nojE 


14- 04 


22-2tf<* 


34-12 


35-170 


36- 


12 


37- 4 40-43# 




4t>- S# 


4S-16* 


58-38* 


64*23 


7tf- 




72-20 72-34 




72-36* 


72-39# 


74-34 


75-37 


86- 


8 


91-2(30 106-27 




1 10-34A 














MOv*YT 


Id- b 


1*- 0 


20-44 


/4-41 


83- 


11 


83-20 108-19* 


HPUP 


109-42 


121-1?* 














lv^-26 




121- U 












2/- 9 


1 2 1 - 1 a 


121-40* 










rtSd*LK 


121- 4 


121-26 


121-36* 










dScJfCNT 


27-13 


109-33 


lib- 6 


121-41* 










12i- 9 


121-2$ 


121-43?* 












2^-19 


27-25$ 


ll«5-4»e 


121-42* 









Figure 8-2 

Excerpts from CREF Listing to Accompany Figure 8-1. 
Note particularly the CREF references for ENDP, 
ENDP2, and MODE. 
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APPENDIX A 



MACRO-11 CHARACTER SETS 



A.l ASCII CHARACTER SET 



EVEN 


7-BIT 




PARITY 


OCTAL 




BIT 


CODE 


CHARACTER 


0 


8 a of 

y f r 


NUL 


1 


Ml 


SOU 


1 


m 


STX 


9 


m 


ETX 


l 




EOT 






ENO 


0 


006 


ACK 


l 




BEL 


l 


019 


BS 




011 
// -u j- 


HT 


9 


012 


LF 


1 


013 


VT 


0 


014 


FF 


1 


015 


CR 


1 


016 


SO 


0 


017 


SI 


1 


020 


DLE 


0 


021 


DC1 


0 


022 


DC2 


1 


023 


DC3 


0 


024 


DC4 


1 


025 


NAK 


1 


026 


SYN 


9 


027 


ETB 



REMARKS 

NULL , TAPE FEED, CONTROL/SHIFT/P . 

START OF HEADING: ALSO SOM, START 

OF MESSAGE, CONTROL/A. 

START OF TEXT; ALSO EOA, END OF 

ADDRESS, CONTROL/B. 

END OF TEXT; ALSO EOM, END OF 

MESSAGE, CONTROL/C. 

END OF TRANSMISSION (END) ; SHUTS 

OFF TWX MACHINES, CONTROL/D . 

ENQUIRY (ENQRY) ; ALSO WRU, 

CONTROL/E . 

ACKNOWLEDGE; ALSO RU, CONTROL/F . 
RINGS THE BELL. CONTROL/G . 
BACKSPACE; ALSO FEO, FORMAT 
EFFECTOR. BACKSPACES SOME 
MACHINES, CONTROL/H. 
HORIZONTAL TAB. CONTROL/I. 
LINE FEED OR LINE SPACE (NEW LINE) ; 
ADVANCES PAPER TO NEXT LINE, DUPLI- 
CATED BY CONTROL/ J. 
VERTICAL TAB (VTAB) . CONTROL/K. 
FORM FEED TO TOP OF NEXT PAGE 
(PAGE) . CONTROL/L. 
CARRIAGE RETURN TO BEGINNING OF 
LINE. DUPLICATED BY CONTROL/M. 
SHIFT OUT; CHANGES RIBBON COLOR TO 
RED. CONTROL/N. 

SHIFT IN; CHANGES RIBBON COLOR TO 
BLACK. CONTROL/O. 

DATA LINK ESCAPE. CONTROL/B (DC0) . 
DEVICE CONTROL 1, TURNS TRANSMITTER 
(READER) ON, CONTROL/Q (X ON) . 
DEVICE CONTROL 2, TURNS PUNCH OR 
AUXILIARY ON. CONTROL/R (TAPE, 
AUX ON) . 

DEVICE CONTROL 3, TURNS TRANSMITTER 
(READER) OFF, CONTROL/S (X OFF). 
DEVICE CONTROL 4, TURNS PUNCH OR 
AUXILIARY OFF. CONTROL/T (AUX OFF). 
NEGATIVE ACKNOWLEDGE; ALSO ERR, 
ERROR. CONTROL/U. 

SYNCHRONOUS FILE (SYNC) . CONTROL/V. 
END OF TRANSMISSION BLOCK; ALSO LEM, 
LOGICAL END OF MEDIUM. CONTROL/W. 
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J 
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REMARKS 

CANCEL (CANCL) . C0NTR0L/X. 
END OF MEDIUM . C0NTR0L/Y . 
SUBSTITUTE . C0NTR0L/Z . 
ESCAPE. C0NTR0L/SHIFT/K • 
FILE SEPARATOR. C0NTR0L/SHIFT/L . 
GROUP SEPARATOR. C0NTR0L/SHIFT/M . 
RECORD SEPARATOR. CONTROL/SHIFT/N . 
UNIT SEPARATOR. CONTROL/SHIFT/0 . 
SPACE . 



ACCENT ACUTE OR APOSTROPHE. 
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EVEN 


7-BIT 


PARITY 


OCTAL 


BIT 


CODE 


9 


129 


1 


121 


1 


122 


9 


123 


i 


124 


9 


125 


9 


126 


1 

X 


1 97 


1 


130 


9 


131 


9 


132 


l 


133 


9 


134 


l 


135 


l 


136 


9 


137 


9 


140 


l 


141 


l 


142 


9 


143 


l 


144 


9 


145 


9 


146 


l 


147 


l 


150 


9 


151 


9 


152 


l 


153 


9 


154 


l 


155 


l 


156 


9 


157 


l 


160 


9 


lol 


9 


162 


l 


163 


9 


164 


l 


165 


l 


166 




167 


9 


170 


l 


171 


i 


172 




173 


l 


174 


9 


175 


9 


176 


l 


177 



CHARACTER 

P 
Q 
R 
S 
T 
U 
V 
W 
X 
Y 
Z 
[ 

\ 
] 

+ 



a 
b 
c 
d 
e 
f 

g 

h 
i 

j 
k 
1 
m 
n 
o 
P 

q 

r 
s 
t 
u 

v 
w 

X 

y 

z 



REMARKS 



SHIFT/K. 

SHIFT/L. 

SHIFT/M. 
* 

** 

ACCENT GRAVE 



DEL 



THIS CODE GENERATED BY ALT MODE. 
THIS CODE GENERATED BY PREFIX KEY 
(IF PRESENT) 
DELETE, RUB OUT, 



* + appears as A on some machines . 

** appears as _ (underscore) on some machines, 
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A. 2 RADIX- 50 CHARACTER SET 



Character ASCII Octal Equivalent Radix-50 Equivalent 

space 40 0 

A-Z 101 - 132 1 - 32 

$ 44 33 

56 34 

unused 35 

0-9 60 - 71 36 - 47 

The maximum Radix-50 value is, thus, 

47*50 2 + 47*50 + 47 = 174777 

The following table provides a convenient means of translating 
between the ASCII character set and its Radix-50 equivalents. 
For example, given the ASCII string X2B, the Radix-50 equivalent 
is (arithmetic is performed in octal) : 

X = 113000 
2 = 002400 
B = 000002 
X2B = 115402 
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Single Char. 










or 
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TP 
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E 


000005 


r 


022600 

yj £• £t\j y> y) 


F 


000360 


F 


000006 




y) Z J / )0 )0 


G 


000430 


G 


000007 


XI 


Of^l 000 
j0 o d.yf yt yt 


H 


000500 


H 


000010 


T 


0 *34 1 00 


I 


000550 


I 


000011 




017200 
y) o / £iyj yj 


J 


000620 


J 


000012 


K 


042300 

yj n *j y/ yt 


K 


000670 


K 


000013 


L 


yt it *j "a yt yj 


L 


000740 


L 


000014 


M 


050500 

y> *jyi jyj yj 


M 


001010 


M 


000015 


N 


053600 


N 


001060 


N 


000016 


o 


056700 

yj ~j \j i yt yj 


0 


001130 


0 


000017 


p 


062000 

yj \j yj yj yj 


P 


001200 


P 


000020 


o 


065100 

W U <J X v v 


Q 


001250 


Q 


000021 


R 


070200 

y» 1 yj t*yj yj 


R 


001320 


R 


000022 


S 


073300 

^t/ / >j *j yj yj 


S 


001370 


S 


000023 


T 

X 


yj 1 \> '•tyjyi 


T 


001440 


T 


000024 


TT 


1 01 500 

_L)0 ±.^jyjyj 


U 


001510 


U 


000025 


V 


1 04600 

^yj ^±\jyj yj 


V 


001560 


V 


000026 


vv 


1 07700 
±.y> i i yf y} 


w 


001630 


W 


000027 


y 


111 00(0 

A- J- ~j yj fJyB 


X 


001700 


X 


000030 


V 

X 


1161 00 


Y 


001750 


Y 


000031 




1 21 200 

J. J. /L yj yj 


Z 


002020 


Z 


00003 2 






$ 


002070 


$ 


000033 




127400 




002140 




000034 


unused 


i o o c tf/Y 

1 3ZDy5y5 


unused 


002210 


unused 


000035 


0 


135600 


0 


002260 


0 


000036 


1 


140700 


1 


002330 j 


1 


000037 


2 


144000 


2 


002400 


2 


000040 


3 


147100 


3 


002450 


3 


000041 


4 


152200 


4 


002520 


4 


000042 


5 


155300 


5 


002570 


5 


000043 


6 


160400 


6 


002640 


6 


000044 


7 


163500 


7 


002710 


7 


000045 


8 


166600 


8 


002760 


8 


000046 


9 


171700 


9 


003030 


9 


000047 
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APPENDIX B 
MACRO- 11 ASSEMBLY LANGUAGE AND ASSEMBLER 



B.l SPECIAL CHARACTERS 



Character 



Function 



form feed 
line feed 
carriage return 
vertical tab 



tab 

space 

# 
@ 
( 



) 

, (comma) 



* 

/ 
& 
i 



+ 

\ 



(apostrophe) 



Source line terminator 

Source line terminator 

Formatting character 

Source line terminator 

Label terminator 

Direct assignment indicator 

Register term indicator 

Item terminator 
Field terminator 

Item terminator 
Field terminator 

Immediate expression indicator 

Deferred addressing indicator 

Initial register indicator 

Terminal register indicator 

Operand field separator 

Comment field indicator 

Arithmetic addition operator 
or auto increment indicator 

Arithmetic subtraction operator 
or auto decrement indicator 

Arithmetic multiplication operator 

Arithmetic division operator 

Logical AND operator 

Logical OR operator 

Double ASCII character indicator 

Single ASCII character indicator 

Assembly location counter 

Initial argument indicator 

Terminal argument indicator 

Universal unary operator 
Argument indicator 

MACRO numeric argument indicator 
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B.2 ADDRESS MODE SYNTAX 



n is an integer between 0 and 7 representing a register. R is a 
register expression, E is an expression, ER is either a register 
expression or an expression in the range 0 to 7 . 



Format 



Address 

Mode 

Name 



Register 



Address 

Mode 

Number 

On 



@R or (ER) Deferred Register In 



(ER) + 



(ER) + 



Autoincrement 



Deferred Auto- 
increment 



2n 



3n 



Meaning 

Register R contains the op- 
erand. R is a register ex- 
pression. 

Register R contains the op- 
erand address. 

The contents of the regis- 
ter specified by ER are in- 
cremented after being used as 
the address of the operand. 

ER contains the pointer to 
the address of the operand. 
ER is incremented after use. 



(ER) 



@- (ER) 



E (ER) 



@E (ER) 



Autodecrement 



Deferred Auto- 
decrement 



Index 



Deferred Index 



4n The contents of register ER 

are decremented before being 
used as the address of the 
operand. 

5n The contents of register ER 

are decremented before being 
used as the pointer to the 
address of the operand. 

6n E plus the contents of the 

register specified, ER, is 
the address of the operand. 

7n E added to ER gives the point- 

er to the address of the oper- 
and . 



#E 
<3#E 



@E 



Immediate 
Absolute 

Relative 



27 E is the operand 

37 E is the address of the oper- 

and. 

67 E is the address of the oper- 

and . 



Deferred Relative 77 



E is the pointer to the ad- 
dress of the operand. 
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B. 3 INSTRUCTIONS 

The instructions which follow are grouped according to the operands 
they take and the bit patterns of their op-codes. 

In the instruction type format specification, the following symbols 
are used: 



OP Instruction mnemonic 

R Register expression 

E Expression 

ER Register expression or expression 

0<ER<7 

AC Floating point register expression 

A General address specification 

In the representation of op-codes, the following symbols are used: 

SS Source operand specified by a 6-bit address mode. 

DD Destination operand specified by a 6-bit address mode. 

XX 8-bit offset to a location (branch instructions) . 

R Integer between 0 and 7 representing a general register. 

Symbols used in the description of instruction operations are: 



SE Source Effective address 

FSE Floating Source Effective Address 

DE Destination Effective address 

FDE Floating Destination Effective Address 

| | Absolute value of 

() Contents of 

■> Becomes 



The condition codes in the processor status word (PS) are 
affected by the instructions. These condition codes are represented 
as follows: 



N Negative bit: 

Z Zero bit: 

V overflow bit: 

C Carry bit: 



set if the result is 
set if the result is 
set if the operation 
set if the operation 



negative 
zero 

caused an overflow 
caused a carry 
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In the representation of the instruction's effect on the 
condition codes, the following symbols are used: 

* Conditionally set 
Not affected 

0 Cleared 

1 Set 

To set conditionally means to use the instruction's result to 
determine the state of the code (see the PDP-11 Processor Handbook ) . 

Logical operations are represented by the following symbols: 

! Inclusive OR 
^) Exclusive OR 
& AND 

(used over a symbol) NOT (i.e., l f s complement) 



B.3.1 Double-Operand Instructions 
Instruction type format: Op A, A 

Op-Code Mnemonic Stands for Operation 



01SSDD 


MOV 


11SSDD 


MOVB 


02SSDD 


CMP 


12SSDD 


CMPB 


03SSDD 


BIT 


13SSDD 


BITB 


04SSDD 


BIC 


14SSDD 


BICB 


05SSDD 


BIS 


15SSDD 


BISB 


06SSDD 


ADD 


16SSDD 


SUB 



MOVe 

MOVe Byte 

CoMPare 
CoMPare Byte 

Bit Test 

Bit Test Byte 

Bit Clear 

Bit Clear Byte 

Bit Set 

Bit Set Byte 

ADD 

SUBtract 



(SE)-*DE 

(SE) - (DE) 

(SE) & (DE) 

(SE) & (DE)^DE 

(SE) I (DE)+DE 

(SE) + (DE)+DE 
(DE)-(SE)^ E 



Status Word 
Condition Codes 
N Z V C 

* * 0 - 

* * * * 

* * 0 - 

* * o 

* * 0 - 

* * * * 

* * * * 
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B.3.2 Single-Operand Instructions 
Instruction type format: Op A 
Op -Code Mnemonic Stands for 



Operation 



Status Word 
Condition Codes 



N 



V 



0050DD 
1050DD 

0051DD 
1051DD 

0052DD 
1052DD 

0053DD 
1053DD 

0054DD 
1054DD 

0055DD 
1055DD 

0056DD 
1056DD 

0057DD 
1057DD 

0060DD 

1060DD 



CLR 
CLRB 

COM 
COMB 

INC 
INCB 

DEC 
DECB 

NEG 
NEGB 

ADC 
ADCB 

SBC 
SBCB 

TST 
TSTB 

ROR 

RORB 



CLear 
CLear Byte 

COMplement 
COMplement Byte 

INCrement 
INCrement Byte 

DECrement 
DECrement Byte 

NEGate 
NEGate Byte 

ADd Carry 

ADd Carry Byte 

SuBtract Carry 
SuBtract Carry Byte 



TeST 

TeST Byte 

ROtate Right 

ROtate Right 
Byte 



0+DE 
(DE)-HDE 
(DE)+1+DE 
(DE)-1+ DE 
(DE)+1+ DE 
(DE) + (C)+ DE 
(DE) - (C)-*- DE 
(DE) -0-^ DE 



even or odd byte 



33 * 



0 0 
0 1 



* * 

0 0 

* * 

* * 



0061DD ROL ROtate Left pQ <-C 



>] 



* * * * 



106 1DD ROLB 



ROtate Left <-[ 
Byte " " 



even or odd byte 



* * * * 



0062DD ASR Arithmetic 

Shift Right 



C 18 14 



□ 
<3_ 



il l 



* * * * 



1062DD ASRB Arithmetic 

Shift Right 
Byte 



□ 
1 



even or odd byte 



MM 



* * * * 



0063DD ASL Arithmetic 

Shift Left 



□ J3X 



o * * * * 



106 3DD ASLB Arithmetic 

Shift Left 
Byte 



even or odd byte 

□ JIM Ml 



* * * * 



cT6 



EE 
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Op-Code Mnemonic Stands for 



Operation 



V 



0001DD JMP JuMP 

000 3DD SWAB SWAp Bytes 



DE+ PC 



□ 



The following instructions are available on the PDP-11/45 only: 



0065DD 
1065DD 
0066DD 

1066DD 

1701DD 
0067DD 



0707DD 
0707DD 



MFPI Move From Previ- 
ous Instruction 
space 

MFPD Move from 
Previous 
Data space 

MTPI Move To 
Previous 
Instruction 
space 

MTPD Move To 
Previous 
Data space 

LDFPS Load FPP Pro- 
gram Status 

SXT Sign eXTend 



NEGD NEGate Double 
NEGF NEGate Floating 



See Chapter 6 
in PDP-ll/45 
Processor 
Handbook 



(DE)-> FPS 



J2f+ DE if N bit 

clear 
-1+ DE if N bit 
is set 



- (FDE) 
- (FDE) 



FDE 
FDE 



FN FZ 
* * 



FV FC 
0 0 



1702DD 

1703DD 

1704DD 
1704DD 
1705DD 
1705DD 



STFPS STore Floating 
Point processor 
program Status 

STST STore floating 
point processor 
STatus 

CLRD CLeaR Double 

CLRF CLeaR Floating 

TSTD TeST Double 

TSTF TeST Floating 



See Chapter 7 
in PDP-11/45 
) Processor 
Handbook 



0+ FDE 
0+ FDE 

(FDE)-^FDE 
(FDE) -0N-FDE 



0 
0 
* 



1 0 

1 0 

* 0 

* 0 
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FN FZ FV FC 



1706DD ABSD make ABSolute 

Double 

1706DD ABSF make ABSolute 

Floating 

B.3.3 Operate Instructions 

Instruction Type format: Op 

Op-Code Mnemonic Stands for 

000000 HALT HALT 

0000001 WAIT WAIT 



0000002 



RTI ReTurn from 
Interrupt 



000005 



RESET RESET 



| FDE | -*FDE 
I FDE I ->FDE 



0*00 
0*00 



Operation N 

The computer 
stops all 
functions. 

The computer 
stops and waits 
for an interrupt. 

The PC and PS * 
are popped off 
the SP stack: 

( (SP) )-* PC 
(SP)+2+ SP 
( (SP) )+ PS 
(SP)+2-> SP 

RTI is also used 
to return from 
a trap. 

Returns all I/O 
devices to power- 
on status. 



000241 


CLC 


CLear Carry bit 


0- 


C 








0 


000261 


SEC 


SEt Carry bit 


1+ 


C 








1 


000242 


CLV 


CLear overflow 


0- 


V 






0 








bit 














000262 


SEV 


SEt overflow 


1+ 


V 






1 








bit 














000244 


CLZ 


CLear Zero bit 


0+ 


Z 




0 






000264 


SEZ 


SEt Zero bit 


l-> 


z 




1 






000250 


CLN 


CLear Negative 


0- 


N 


0 












bit 














000270 


SEN 


SEt Negative 


1+ 


N 


1 












bit 














000243 




Clear overflow 


0+ 


V 






0 


0 






and Carry bits 


0+ 


c 










000254 


CNZ 


Clear Negative 


0+ 


N 


0 


0 










and Zero bits 


0+ 


z 
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000257 



000277 



CCC Clear all 
Condition 
Codes 



SCC Set all Con- 
dition Codes 



0+ N 
0+ Z 
0+ V 
j2K C 

1+ N 
1+ Z 
1+ V 
1+ C 



000240 



NOP No OPeration 



The following instructions are available on the PDP-11/45 only: 



Op-Code Mnemonic Stands for 

170000 CFCC Copy Floating 

Condition 
Codes 



FN FZ FV FC 
* * * * 



Operation FN F_Z FV 

Copy FPP con- 
dition codes 
into CPU con- 
dition codes. 



000006 



170011 



170001 



170002 



170012 



RTT ReTurn from 
inTerrupt 



SETD SET Double 

floating mode 



SETF SET Floating 
mode 



SETI SET Integer 
mode 



SETL SET Long integer 
mode 



Same as RTI * 
instruction but 
inhibits trace 
trap 

FPP set to 
double pre- 
cision mode 

FPP set to 
single pre- 
cision mode 

FPP set for 
integer data 
(16 bits) 

FPP set for long - 
integer data 
(32 bits) 
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B.3.4 Trap Instructions 



Instruction type format: Op or Op E where 0 < E < 377 



*0P (only) 



8 



Op-Code Mnemonic Stands for 



*000003 



*000004 



104000- 
104377 



104400- 
104777 



BPT Breakpoint 
Trap 



IOT Input/Output 
Trap 



EMT EMulator Trap 



TRAP TRAP 



Operation 

Trap to loca- 
tion 14. This 
is used to call 
ODT. 



Trap to location * 
20. This is 
used to call IOX. 

Trap to location * 
30. This is used 
to call system 
programs. 

Trap to location * 
34. This is used 
to call any rou- 
tine desired by 
the programmer . 



Status Word 
Condition Codes 
N Z V C 

* * * * 



B.3.5 Branch Instructions 



Instruction type format: Op E where -128 1Q < (E-.-2)/2 < 12 7 1Q 



Op-Code Mnemonic 



Stands for 



Condition to be met if 
branch is to occur 



0004XX 
0010XX 
0014XX 
0020XX 

0024XX 
0030XX 
0034XX 

1000XX 
1004XX 
1010XX 
1014XX 
1020XX 
1024XX 



BR 
BNE 
BEQ 
BGE 

BLT 
BGT 
BLE 

BPL 

BMI 

BHI 

BLOS 

BVC 

BVS 



BRanch always 

Branch if Not Equal (to zero) 

Branch if EQal (to zero) 

Branch if Greater than or Equal 
(to zero) 

Branch if Less Than (zero) 

Branch if Greater Than (zero) 

Branch if Less than or Equal 
(to zero) 

Branch if PLus 

Branch if Minus 

Branch if Higher 

Branch if LOwer or Same 

Branch if overflow Clear 

Branch if overflow Set 



Z=0 
Z=l 

N (?) V=0 

N 0 V=l 

Z! (N (J) V)=0 

Z!*> (N (?) V)=l 

N=0 
N=l 

C I Z=0 
C ! Z = l 
V=0 
V=l 
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Op-Code Mnemonic 



Stands for 



1030XX BCC Branch if Carry Clear (or 

(or BHIS) Branch if Higher or Same) 

1034XX BCS Branch if Carry Set (or 

(or BLO) Branch if LOwer) 



Condition to be met if 
b ranch is to occur 

C=0 



C=l 



B.3.6 Register Destination 
Instruction type format: OP ER ,A 



Op-Code Mnemonic Stands for 



004RDD 



JSR 



Jump to 
SubRoutine 



Operation 



Status Word 
Condition Codes 
N Z V C 



Push register 
on the SP stack, 
put the PC in the 
register : 

DE+ TEMP (TEMP= 
temporary storage 
register internal 
to processor.) 

(SP)-2+ SP 
(REG)+ (SP) 
(PC)+ REG 
(TEMP)+ PC 

The following instruction is available only on the PDP-11/45: 



074RDD 



XOR 



exclusive OR (R) Q) DE+ DE 



B.3.7 Register-Offset 
Instruction type format: OP R,E 



Op -Code Mnemonic Stands for 

077RDD SOB Subtract One 

and Branch 

B.3.8 Subroutine Return 

Instruction type format: Op ER 

Op-Code Mnemonic Stands for 

00020R RTS ReTurn from 

Subroutine 



Operation 

(R)-l-^R 
PC-(2*DE)+ PC 



Operation 



N 



N 



Put register in 
PC and pop old 
contents from SP 
stack into 
register 



V 
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B.3.9 Source-Register 

The following instructions are available on the PDP-11/45 only: 
Instruction type format: Op A,R 



Op-Code Mnemonic Stands for 

071RSS DIV Divide 

070RSS MUL MULtiply 

0 72RSS ASH Arithmetic 

SHift 



Operation 

R,Rvl/ (SRC)+ R, Rvl 

R*(SRC) + R,Rvl 

R is shifted accord- 
ing to low-order 
6-bits of source 



Status Word 
Condition Codes 
N Z, V C 

* * * * 

* * o * 

* * * * 



or 



073RSS 



ASHC 



Arithmetic 

SHift 

Combined 



R: 
R+l 



R, Rvl are shifted 
according to low- 
order 6 bits of 
source 

E 



± 



R: D-4 



or 



R+l: 



B.3.10 Floating-Point Source Double Register 

The following instructions are available on the PDP-11/45 only: 



Instruction type format: Op A, AC 



Status Word Floating 
Condition Codes 



Op-Code Mnemonic 


Stands for 


Operation 


FN 


FZ 


FV 


FC 


172 (AC)SS 


ADDD 


ADD Double 


(FSE) +AC+ AC 


* 




* 


0 


172 (AC)SS 


ADDF 


ADD Floating 


(FSE) +AC-* AC 








0 


173(AC+4)SS 


CMPD 


CoMPare 


(FSE) -AC 


* 




0 


0 






Double 












173 (AC+4)SS 


CMPF 


CoMPare 


(FSE) -AC 


* 


* 


0 


0 






Floating 












174 (AC+4)SS 


DIVD 


Divide 


AC/ (FSE) AC 


* 






0 






Double 












174 (AC+4)SS 


DIVF 


Divide 


AC / (FSE) -> AC 


* 




* 


0 






Floating 












177 (AC+4)SS 


LDCDF 


LoaD and Con- 


(FSE) •* AC 




* 


* 


0 



from Double 
to Floating 



B-ll 



Status Word Floating 
Condition Codes 

Op-Code Mnemonic Stands for Operation FN FZ^ F V FC 

177(AC+4)SS LDCFD LoaD and Con- (FSE) * AC * * * 0 

vert from 
Floating to 
Double 

172(AC+4)SS LDD LoaD Double (FSE) + AC * * 0 0 

172(AC+4)SS LDF LoaD Floating (FSE) ■+ AC * * 0 0 

171(AC+4)SS MODD Multiply and AC* (FSE) + AC,AC1 * * * 0 

integerize 
double 

171(AC+4)SS MODF Multiply and AC* (FSE) •*■ AC * * * 0 

integerize 
floating-point 

171(AC)SS MULD MULtiply AC* (FSE) -> AC * * * 0 

Double 

171(AC)SS MULF MULtiply AC* (FSE) + AC * * * 0 

Floating 

173(AC)SS SUBD SUBtract (FSE) -AC-* AC * * * 0 

Double 

173(AC)SS SUBF SUBtract (FSE) -AC+ AC * * * 0 

Floating 

B.3.11 Source - Double Register 

The following instructions are available on the PDP-11/45 only: 
Instruction type format: Op A, AC 

Status Word 
Condition Codes 

Op-Code Mnemonic Stands for Operation EN FZ FV FC 

177(AC)SS LDCID LoaD and Con- (SE) + AC * * * 0 

vert Integer 
to Double 

177(AC)SS LDCIF LoaD and Con- (SE) + AC * * * 0 

vert Integer 
to Floating 

177(AC)SS LDCLD LoaD and Con- (SE) ■> AC * * * 0 

vert Long 
integer to 
Double 

177(AC)SS LDCLF LoaD and Con- (SE) + AC * * * 0 

vert Long In- 
teger to 
Floating 

176(AC+4)SS LDEXP LoaD EXPonent (SE) +200/->- AC * * 0 0 
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B.3.12 Double Register - Destination 

The following instructions are available on the PDP-11/45 only: 
Instruction type format: Op AC , A 



Op-Code Mnemonic Stands for 



Operation 



176(AC)DD STCFD STore, Con- AC+ FDE 

vert from 
Floating to 
Double 

176(AC)DD STCDF STore, Con- AC-*- FDE 

vert from 
Double to 
Floating 

175(AC+4)DD STCDI 1 STore, Con- AC+ FDE 

vert from 
Double to 
Integer 

175(AC+4)DD STCDL 1 STore, Con- AC+ FDE 

vert from 
Double to 
Long integer 

175(AC+4)DD STCFI 1 STore, Con- AC-* FDE 

vert from 
Floating to 
Integer 



175(AC+4)DD STCFL STore, Con- 
vert from 
Floating to 
Long integer 



AC-* FDE 



174(AC)DD STD 
174(AC)DD STF 



STore Double AO* FDE 
AC-* FDE 



STore 
Floating 



17 5(AC)DD STEXP 1 STore 

EXPonent 

B.3.13 Number 



AC EXP- 200+ DE 



Status Word 
Condition Codes 
FN FZ FV FC 



The following instruction is available on the PDP-11/45 only! 

Status Word 
Condition Codes 

Op-Code Mnemonic Stands for Operation N Z_ V C 



0064NN 



MARK MARK 



Stack cleanup on 
return from sub- 
routine . 



1 These instructions set both the floating-point and processor condition 
codes as indicated ♦ 



B-13 



B.3.14 Priority 



The following instruction is available on the PDP-11/45 only. 

Status Word 
Condition Codes 

Op-Code Mnemonic Stands for Operation N Z_ V C 

00023N SPL Set Priority N+ PC (bits 7-5) - 

Level 



B.4 ASSEMBLER DIRECTIVES 



Form 



Operation 



Described in 
Manual Section 



A single quote character 
(apostrophe) followed by 
one ASCII character gener- 
ates a word containing the 
7-bit ASCII representation 
of the character in the low- 
order byte and zero in the 
high-order byte. 



6.3.3 



A double quote character fol- 
lowed by two ASCII characters 
generates a word containing 
the 7-bit ASCII representation 
of the two characters. 



6.3.3 



+ Bn 



Temporary radix control; 
causes the number n to be 
treated as a binary number. 



6.4.2 



tCn 



Creates a word containing the 
one 1 s complement of n. 



6.6.2 



f Dn 



Temporary radix control; causes 
the number n to be treated as 
a decimal number. 



6.4.2 



+ Fn 



Creates a one-word floating 
point quantity to represent n. 



6.6.2 



tOn 



Temporary radix control; causes 
the number n to be treated as 
an octal number. 



6.4.2 



.ASCII string 



Generates a block of data con- 
taining the ASCII equivalent 
of the character string (enclosed 
in delimiting characters) one 
character per byte. 



6.3.4 



.ASCIZ string 



Generates a block of data con- 
taining the ASCII equivalent of 
the character string (enclosed 
in delimiting characters) one 
character per byte with a zero 
byte following the specified 
string . 



6.3.5 
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Form 



Operation 



Described in 
Manual Section 



. ASECT 

. BLKB exp 

• BLKW exp 

.BYTE expl,exp2, 

.CSECT symbol 
.CSECT 

• DSABL arg 
. ENABL arg 



. END 

.END exp 



. ENDC 



. ENDM 

. ENDM symbol 



. EOT 



. ERROR exp r string 



. EVEN 



. FLT2 argl,arg2, . . . 



. FLT4 argl,arg2, . 



. GLOBL syml,sym2, 



Begin or resume absolute sec- 6.9 
tion. 

Reserves a block of storage 6.5.3 
space exp bytes long. 

Reserves a block of storage 6.5.3 
space exp words long. 

Generates successive bytes of 6.3.1 
data containing the octal equiva- 
lent of the expression (s) speci- 
fied. 

Begin or resume named or 6.9 
unnamed relocatable section. 

Disables the assembler function 6.2 
specified by the argument. 

Provides the assembler func- 6.2 
tion specified by the argu- 
ment . 

Indicates the physical 6.7.1 

end of source program. 

An optional argument specifies 

the transfer address. 

Indicates the end of a condi- 6.11 
tion block. 

Indicates the end of the cur- 7.1.2 
rent repeat block, indefinite 
repeat block, or macro. The 
optional symbol, if used, must 
be identical to the macro name. 

Ignored. Indicates End-of- 6.7.2 
Tape which is detected auto- 
matically by the hardware. 

Causes a text string to be output 7.5 
to the command device containing 
the optional expression specified 
and the indicated text string. 

Ensures that the assembly 6.5.1 

location counter contains 

an even address by adding 1 if 

it is odd. 

Generates successive two-word 6.6.1 
floating-point equivalents for 
the floating-point numbers speci- 
fied as arguments. 

Generates successive four-word 6.6.1 
floating-point equivalents for 
the floating-point numbers speci- 
fied as arguments. 

Defines the symbol (s) specified 6.10 
as global symbol (s). 



B-15 



Form 



Operation 



Described in 
Manual Section 



. IDENT symbol Provides a means of labeling 6.1,5 

the object module with the pro- 
gram version number. The symbol 
is the version number between 
paired delimiting characters. 



.IF cond,argl, arg2, . . . Begins a conditional block of 6.11 

source code which is included 
in the assembly only if the 
stated condition is met with 
respect to the argument (s) speci- 
fied. 



.IFF Appears only within a con- 6.11.1 

ditional block and indicates 
the beginning of a section of 
code to be assembled if the 
condition tested false. 



. IFT Appears only within a condi- 6.11.1 

tional block and indicates 
the beginning of a section of 
code to be assembled if the 
condition tested true. 



. IFTF Appears only within a condi- 6.11.1 

tional block and indicates the 
beginning of a section of code 
to be unconditionally assembled. 



.IIF cond,arg, statement Acts as a one-line conditional 6.11.2 

block where the condition is 
tested for the argument speci- 
fied. The statement is assembled 
only if the condition tests true. 

.IRP sym,<argl,arg2, . . .> Indicates the beginning of an 7.6 

indefinite repeat block in 
which the symbol specified is 
replaced with successive ele- 
ments of the real argument list 
(which is enclosed in angle 
brackets) . 



.IRPC sym, string Indicates the beginning of an 7.6 

indefinite repeat block in 
which the symbol specified takes 
on the value of successive char- 
acters in the character string. 



.LIMIT Reserves two words into which 6.8 

the Linker inserts the low and 
high addresses of the relocated 
code . 
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Form 



Operation 



Described in 
Manual Section 



.LIST Without an argument, .LIST 6.1.1 

.LIST arg increments the listing level 

count by 1. With an argument, 
.LIST does not alter the list- 
ing level count but formats 
the assembly listing accord- 
ing to the argument specified. 



.MACRO sym, argl,arg2, . . .Indicates the start of a macro 

named sym containing the dummy 
arguments specif led . 



.MEXIT 



, NARG symbol 



Causes an exit from the cur- 
rent macro or indefinite repeat 
block. 

Appears only within a macro 
definition and equates the 
specified symbol to the number 
of arguments in the macro call 
currently being expanded. 



7.1.1 



7.1.3 



7.4 



, NCHR sym, string 



. NLIST 

. NLIST arg 



. NTYPE sym, arg 



.ODD 



Can appear anywhere in a source 7.4 
program; equates the symbol 
specified to the number of 
characters in the string (en- 
closed in delimiting characters) . 

Without an argument, . NLIST de- 6.1.1 

crements the listing level 

count by 1. With an argument, 

.NLIST deletes the portion of 

the listing indicated by the 

argument. 

Appears only in a macro defini- 7.4 
tion and equates the low-order 
six bits of the symbol specified 
to the six- bit addressing mode 
of the argument. 

Ensures that the assembly loca- 6.5.1 
tion counter contains an odd 
address by adding 1 if it is 
even. 



, PAGE 



, PRINT exp, string 



. RADIX n 



Causes the assembly listing to 6.1.6 
skip to the top of the next 
page . 

Causes a text string to be out- 7.5 
put to the command device con- 
taining the optional expression 
specified and the indicated text 
string. 

Alters the current program radix 6.4.1 

to n, where n can be 2, 4, 8, or 

10. 
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Form 



Operation 



Described in 
Manual Section 



. RAD50 string 



Generates a block of data con- 
taining the Radix-50 equivalent 
of the character string (enclosed 
in delimiting characters) . 



6.3.6 



, REPT exp 



. SBTTL string 



, TITLE string 



Begins a repeat block. Causes 7.7 
the section of code up to the 
next . EN DM or . ENDR to be re- 
peated exp times. 

Causes the string to be printed 6.1.4 
as part of the assembly listing 
page header. The string part of 
each .SBTTL directive is collected 
into a table of contents at the 
beginning of the assembly listing. 

Assigns the first symbolic name 6.1.3 
in the string to the object mod- 
ule and causes the string to ap- 
pear on each page of the assembly 
listing. One .TITLE directive 
should be issued per program. 



.WORD expl,exp2 , . . . Generates successive words of 6.3.2 

data containing the octal 
equivalent of the expression (s) 
specified. 



B-18 



APPENDIX C 
PERMANENT SYMBOL TABLE 



PST PERMANENT SYMBOL TABLE MACRO V004A »AGE 1 



I .TITLE PST PERMANENT SYMBOL TABLE 
2 

3 t COPYRIGHT 1972 DIGITAL EQUIPMENT CORPORATION 
4 

5 000000' .CSECT PSTSEC 
6 

7 • GLOBL PSTBAS, PSTTOP fLIMITS 

8 . GLOBL WRDSYM f POINTER TO f WORD 
9 

10 000200 DR1» 200 f DESTRUCTIVE REFERENCE IN FIRST 

II 000100 DR2« 100 f DESTRUCTIVE REFERENCE IN SECOND 
12 

13 •GLOBL DFLGEV, DFLGBM, DFLCND, DFLMAC, DFLSMC 
14 

15 000020 DFLGEV« 020 » DIRECTIVE REQUIRES EVEN LOCATIO 

16 000010 DFLGBM. 010 IDIPECTIVE USES BYTE MODE 

17 000004 0FLCND* 004 J CONDITIONAL DIRECTIVE 

18 000002 DFLMAC* 002 fMACRO DIRECTIVE 

19 000001 DFLSMC« 001 t M C ALL 
20 

21 

22 .IIF DF X45, XFLTG* 0 

23 .IIF DF XMACRO, XSMCAL* ® 
24 

25 9 MACRO OPCDEF NAME, CLASS, VALUE* FLAGS, COND 

26 .IF NB <COND> 

27 • IF DF COND 

28 .MEXIT 

29 ,ENDC 

30 t ENDC 

31 .RAD50 /NAME/ 

32 .BYTE FLAGS+0 

33 •GLOBL OPCL'CLASS 

34 .BYTE 200+OPCL»CLASS 

35 .WORD VALUE 

36 t ENDM 
37 

38 .MACRO DIRDEF NAME, FLAGS, COND 

39 .IF NB <COND> 

40 .IF DF COND 

41 .MEXIT 

42 .ENDC 

43 . ENDC 

44 .GLOBL NAME 

45 .RAD50 /.'NAME/ 

46 .BYTE FLAGS+0 

47 .BYTE 0 

48 ,WORD NAME 

49 . ENDM 
50 

51 00000 PSTBASJ >BASE 

C-1 



PST PERMANENT 


SYMBOL TABLE 


MACPO 


V004A 


PASS 2 








1 000000 


OPCDEF 


<AB8D 


>• 


01 f 


170600, 


DPI # 


X45 


j% fm mm tm M j tm. 

2 1 


OPCDEF 


<ABSF 


>t 


a a 

01 « 


1 70600 , 


DPI . 


X45 


3 00002" 


OPCDEF 


<ADC 


>$ 


01 * 


005500 , 


DPI 




4 000030 


OPCDEF 


<AQCB 




01 * 


105500, 


DRl 




C 0101 CI 01 jl 01 

0 W t" Iw w ** w 




m* k f\ A 

< ADD 


># 


01 O 

02 1 


A At A A A A 

060000 , 


DR2 




£ (7| d rt A c a 


Q p CDtr 


<ADDD 


>* 


1 1 9 


i A A A A 

1 72000 , 


DR2, 


X45 


7 01 01 01 01 £01 




/l MAP 


>f 


4 4 

11* 


4 9 A A A A 

1 72000 , 


ABA 

DR2, 


W A AC 

X45 


8 0000/0 


OPCDEF 


<A§H 


>f 


09f 


A A A A A A 

072000a 


DP2# 


X45 


9 000100 


OPCDEF 


<A$HC 


>• 


09, 


073000, 


0R2# 


X45 


10 00 110 


OPCDEF 


<ASL 


>i 


01- 


006300, 


DRl 




11 00120 


OPCDEF 


<ASLB 


>* 


01 ' 


106300, 


DRl 




12 00130 


OPCDEF 


<ASR 


>- 


01 * 


006200, 


DRl 




13 00140 


OPCDEF 


<ASPB 


># 


01 • 


106200, 


DRl 




14 00150 


OPCDEF 


<BCC 


>f 


04 a 


103000a 






15 0016* 


OPCDEF 


j Pi mk *A 


>$ 


04 a 


103400, 






16 00170 


OPCDEF 


<BE0 


>t 


04 f 


001400, 






17 00200 


«ha ik mm mm 

OPCDEF 


<BGE 


># 


04 a 


A A A A A A 

002000, 






18 00210 


OPCDEF 


<BGT 


>* 


04. 


003000, 






19 00220 


OPCDEF 


<BHI 


>p 


04 | 


101000, 






a fm fm fm 0% *m mm 

20 00230 


OPCDEF 


<BHI3 


>9 


a j 

04 A 


A A H A A A 

I 03000, 






m\ A mm fm 0k j fm 

21 00240 


OPCDEF 


<BIC 


># 


A A 

02, 


0m a A M A A 

040000, 


DR2 




22 00250 


OPCDEF 


<BICB 


>• 


A At 

02 A 


i A n A A A 

1 40000 , 


DR2 




23 00260 


OPCDEF 




>• 


07, 


A B A A A A 

050000, 


DR2 




24 00270 


A A A hrp 

OPCDEF 


j« ■ fin 

<BISB 


># 


02 9 


A mT A A A A 

1 50000, 


AAA 

DP2 




25 00300 


OPCDEF 


<BIT 


>9 


02 , 


A H A A A A 

030000 , 






A JC A A 1 i A 

26 00310 


UPCDEr 


<BITB 






4 1 A A A A 

I 30000 , 






27 00320 


a a a i> rp 

OPCDEF 


<BLF 


>, 


n a 


AAV AAA 

003400 , 






28 00330 


OPCDEF 


<BL0 


>9 


04 f 


4 A V AAA 

103400, 






29 00340 


OPCDEF 


<BL0S 


>9 


04 , 


AAA AAA 

101400, 






30 00350 


OPCDEF 


<BLT 


>9 


04 f 


002400, 






31 00360 


OPCDEF 


<BMT 


>9 


04 f 


1 00400, 






32 00370 


OPCDEF 


«BNE 


>9 


04 a 


001000, 






33 00400 


OPCDEF 


<BPL 


*9 


04, 


1 00000, 






34 00410 


OPCDEF 


<BPT 


>9 


00 A 


000003, 


9 


X45 


35 00420 


OPCDEF 


«BR 


>9 


04. 


000400, 






36 00430 


OPCDEF 


<BVC 


>9 


04, 


102000, 






37 00440 


OPCDEF 


<BVB 


>• 


04, 


102400, 






38 00450 


OPCDEF 


<CCC 


>F 


00 9 


000257, 






•art n a i £ A 

39 00460 


OPCDEF 


<CFCC 


>9 


A A 

00 r 


A I 1 A A A A 

1 70000 , 


9 


X45 




nor* ftcr 


<CLC 




If? " , 


A A A A A A 

00024 1 , 






41 00500 


OPCDEF 


<CLN 


>• 


03, 


000250, 






42 00510 


OPCDEF 


<CL* 


>. 


01, 


005000, 


DRl 




43 00520 


OPCDEF 


<CL*B 


># 


01, 


105000, 


DRl 




44 00530 


OPCDEF 


<CL»D 


>• 


01, 


170400, 


DRl 9 


X45 


45 00540 


OPCDEF 


<CL*F 


>• 


01, 


170400, 


DRl # 


X45 


46 00550 


OPCDEF 


<CLV 


>• 


001, 


000242, 






47 00560 


OPCDEF 


<CL7 


>• 


00, 


000244, 







02 



PST PERMANENT 


SYMBOL TABLE 


MACRO V004A 


»A<$E 3 








1 00057* 


OPCDEF 


<CMP 


>f 


02, 


020000, 






2 00060ft 


OPCDEF 


<CMPB 


>, 


02, 


120000, 






3 0006 1* 


OPCDEF 


<CMPD 


>, 


11, 


173400, 




X45 


4 000620 


OPCDEF 


<CMPF 


>, 


it, 


173400, 


# 


X45 


5 000630 


OPCDEF 


<CH1 


>, 


00, 


000254, 






6 000640 


OPCDEF 


<COM 


>, 


01, 


005100, 


DPI 




7 000650 


OPCDEF 


«COMB 


>, 


01, 


105100, 


DPI 




8 00066* 


OPCDEF 


<DEC 


>, 


01, 


005300 , 


DPI 




9 000670 


OPCDEF 


<DECB 


>9 


01, 


105300, 


DPI 




10 00700 


OPCDEF 


<DIV 


>9 


07, 


071000, 


DR2, 


X45 


ti 00710 


OPCDEF 


<DIVD 


>9 


11, 


174400, 


DP2, 


X45 


12 00720 


OPCDEF 


<DIVF 


>, 


11* 


174400, 


DP2, 


X45 


13 00730 


OPCDEF 


<EMT 


>9 


06, 


104000, 






14 00740 


OPCDEF 


<HALT 


>, 


00, 


000000, 






15 00750 


OPCDEF 


<INC 


>r 


01, 


005200, 


DPI 




16 00760 


OPCDEF 


<INCB 


> f 


01, 


105200, 


DPI 




17 00770 


OPCDEF 


<IOT 


>, 


00, 


000004, 






18 01000 


OPCDEF 


<JMP 


>, 


01, 


000100, 






19 01010 


OPCDEF 


<JSP 


», 


05, 


004000, 


DPI 




20 01020 


OPCDEF 


<LDCDF 


>, 


11, 


177400, 


DP2, 


X45 


21 01030 


OPCDEF 


<LDCFD 


>f 


11, 


177400, 


DR2, 


X45 


22 01040 


OPCDEF 


<LDCID 


>9 


14, 


177000, 


DR2, 


X45 


23 01050 


OPCDEF 


<LDCIF 


>9 


14, 


177*00, 


DR2, 


X45 


24 01060 


OPCDEF 


<LDCLD 


>9 


14, 


177000, 


DR2, 


X45 


25 01070 


OPCDEF 


<LDCLF 


*9 


Uf 


177000, 


DR2, 


X45 


26 01100 


OPCDEF 


<LDD 


>9 


11, 


172400, 


DP2, 


X45 


27 01110 


OPCDEF 


<LDEXP 


>9 


14, 


176400, 


DP2, 


X45 


28 0U20 


OPCDEF 


<LDF 


>9 


11, 


172400, 


DR2, 


X45 


29 01130 


OPCDEF 


«LDFPS 


>9 


01, 


170100, 




X45 


30 01140 


OPCDEF 


<LDSC 


>9 


00, 


170004, 




X45 


31 0115* 


OPCDEF 


<LDUB 


>, 


00, 


170003, 




X45 


32 01160 


OPCDEF 


<MAPK 


>9 


10, 


006400, 


# 


X45 


33 01170 


OPCDEF 


<MFPD 


>9 


01, 


106500, 




X45 


34 01200 


OPCDEF 


<MFPI 


>9 


01, 


006500, 




X45 


35 01210 


OPCDEF 


<MQDD 


>, 


11, 


171400, 


DR2, 


X45 


36 01220 


OPCDEF 


<MODF 


>9 


11, 


171400, 


DR2, 


X45 


37 01230 


OPCDEF 


<MOV 


>9 


02, 


010000, 


DR2 




38 01240 


OPCDEF 


<MOVB 


>9 


02, 


110000, 


DR2 




39 01250 


OPCDEF 


<MTPD 


>9 


01 9 


106600, 


DPI, 


X45 


40 01260 


OPCDEF 


<MTPI 


>9 


01* 


006600, 


DPI, 


X45 


41 01270 


OPCDEF 


<MUL 


>9 


07, 


070000, 


0R2, 


X45 


42 01300 


OPCDEF 


«MULD 


>, 


11* 


17100*, 


DR2, 


X45 


43 01310 


OPCDEF 


<MULF 


>9 


11, 


171*00, 


DR2i 


X45 


44 01320 


OPCDEF 


<NEG 


>9 


01, 


005400, 


DPI 




45 01330 


OPCDEF 


<NEGB 


>, 


01, 


1*5400, 


OR I 




46 01340 


OPCDEF 


<NEC5D 


>9 


01, 


170700, 


DPI, 


X45 


47 01350 


OPCDEF 


<NEGF 


>f 


01, 


170700, 


DR1, 


X45 


48 01360 


OPCDEF 


<NOP 


>9 


00, 


0*0240, 






49 01370 


OPCDEF 


<PESET 


># 


0*, 


000005, 
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1 001400 


OPCDEF 


<POL 


>, 


01, 


006100, 


DPI 




2 00141,0 


OPCDEF 


<ROLB 


>, 


01 9 


106100, 


DPI 




3 001420 


OPCDEF 


<POP 


>, 


01, 


006000, 


DPI 




4 001430 


OPCDEF 


<P0R8 


>9 


01, 


106000, 


DPI 




er m n 4 A a fx 

5 00 1 44 w 


OPCDEF 


<PTT 


> , 


00, 


000002, 






^ rti n 4 a c M 

6 001450 


OPCDEF 


<PT$ 


>9 


03, 


000200, 


DPI 




7 001 46w 


OPCDEF 


<RTT 


> , 


00, 


000006, 




X45 


8 001470 


OPCDEF 


<3BC 


>, 


01, 


005600, 


DPI 




9 001500 


OPCDEF 


<SBCB 


>, 


01, 


105600, 


DPI 




10 01510 


OPCDEF 


<scc 


>9 


00, 


000277, 






11 01520 


OPCDEF 


<SEC 


>, 


00, 


000281, 






12 01530 


OPCDEF 


<SEN 


>, 


00, 


000270, 






13 01540 


OPCDEF 


<SETD 


>, 


00, 


170011, 




X45 


14 01550 


OPCDEF 


<SFTF 


>, 


00, 


170001, 




X45 


15 01560 


OPCDEF 


<SETI 


>, 


00, 


170002, 




X45 


16 01570 


OPCDEF 


<SETL 


>9 


00, 


170012, 




X45 


17 01*00 


OPCDEF 


<SEV 


>, 


00, 


000262, 






18 01610 


OPCDEF 


<SEZ 


> , 


00, 


000264, 






19 01620 


OPCDEF 


<SOB 


>, 


08, 


077000, 


DPI. 


X45 


20 01^30 


OPCDEF 


<8PL 


>, 


13, 


000230, 




X45 


21 01640 


OPCDEF 


<3TA0 


>, 


00, 


170005, 




X45 


22 01650 


OPCDEF 


<STR0 


>9 


00, 


170006, 




X45 


23 01660 


OPCDEF 


<3TCDF 


> , 


12, 


176000, 


DP2, 


X45 


24 01670 


OPCDEF 


<3TCDI 


>, 


12, 


175400, 


DP2, 


X45 


25 01700 


OPCDEF 


<STCDL 




12, 


175400, 


DP2, 


X45 


26 01710 


OPCDEF 


OTCFD 


> , 


12, 


176000, 


DP2, 


X45 


27 01720 


OPCDEF 


<STCpI 


>, 


12, 


175400, 


DP2, 


X45 


28 0173* 


OPCDEF 


<8TCFL 


>, 


12, 


175400, 


DR2, 


X45 


29 01740 


OPCDEF 


<STD 


>, 


12, 


174000, 


DP2, 


X45 


30 01750 


OPCDEF 


<$TFXP 


>9 


12, 


175000, 


DP2, 


X45 


31 01760 


OPCDEF 


<STF 


>9 


12, 


1 74000, 


DP2, 


X45 


32 01770 


OPCDEF 


<STFP$ 


>9 


01, 


170200, 


DPI , 


X45 


33 02000 


OPCDEF 


<8TO0 


>, 


00, 


170007, 




X45 


34 02010 


OPCDEF 


<9TST 


>, 


01, 


170300, 


DPI, 


X45 


35 02020 


OPCDEF 


<5UR 


>, 


02, 


160000, 


DP2 




36 02030 


OPCDEF 


<SUPD 


>, 


11, 


173000, 


DP2, 


X45 


37 02040 


OPCDEF 


<SURF 


>9 


11, 


173000, 


DP2, 


X45 


38 02050 


OPCDEF 


<SWAR 


>, 


01, 


000300, 


DPI 




"art rx o fx £ fx 

39 02060 


OPCDEF 


<SXT 


> , 


01 , 


006700, 


DPI, 


X^5 


40 02070 


OPCDEF 


<TPAP 


>, 


06, 


104400, 






41 02100 


OPCDEF 


<TST 


>, 


01, 


005700, 






42 02110 


OPCDEF 


<TSTB 


>, 


01, 


105700, 






43 02120 


OPCDEF 


<T8TD 


>, 


01, 


170500, 




X45 


44 02130 


OPCDEF 


<TSTF 


>, 


01, 


170500, 




X45 


45 02140 


OPCDEF 


<WAIT 


>, 


00, 


000001 , 






46 02150 


OPCDEF 


<VOP 


>, 


05, 


074000, 


DP2, 


X45 
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MACRO V004A 



i 0101 9 1 £ 0! 


ft T D ft CP 


< ASC. 1 1> 0 


Ps c i o m 

Pr LGB M 




PlNDEr 


-m k A A f 7k. 

<ASC I Z> r 


PFLG8M 




Pit DPNCF 


< A5rC T > 




> 01 01 9 9 1 01 


ft t d rscc 

u I K □ t r 


<BL^B * 




K 0019990) 


ft f PftFF 


>ai i/u v 
* r5L ^ n > f 


ft c I rew 
Pr LGEV 


6 002P10 


ft TPftFF 


% 9 T ! C. * • 


ft PI PQM 

P r L , £ ft M 


7 002240 


w * rs l# c r 






0 10 Wee Ovr? 


ft T DftCC 

U X KUfcr 


ft e a Dl «k. 




0 010199*0" 


U X K \) fc, r 






i 01 0199701 
1 W WC€/lf! 


ft t p ft ccr 


< t N D > 




1 1 0191010! 


ft T 

U I ft u fc " 


c ki ps r» ^ 


ftFi r ki ft 






<r.N0M > § 


ft C 1 U A P 


« *1 01919 01 


ftTPftFF 


* E* II) ft D «v 


ft C 1 MAP 

Up AC. f 


< 4 0191101 


ft t oncer 

□ I Kufcr 


< pJ U T > 




1 <S 0191X01 


ft T P ncr 






1 A 0191*50* 

1 O Y)C. <3s)V> 


u 1 ft U L r 


^r.VtN > 




i 7 0191*0! 




rf* BT 1 T 9 w 


ft C I PCI/ 

Pr V f 


i O n|O170l 
1 " W< Cif w 


P IKufcr 


>ei t a «k. 
<^LT4 > f 


ft C 1 Pffl/ 


i O 01 O Jl fll 01 


PS T D PS C C 

0 1 H D E r 


<C5L08L> 








* f PS P M T w 




9 1 f%0 A Of% 


L> X KDfcr 


< X r > # 


ft CI P ii ft 

Pr IXNP 


2< 0243E 


PS T D r\ C ET 

P X ftPEr 


<IFDF >* 


cm? i k» li rs 

PFLCND 




PS T D PNC C 

p IKPtr 


<IFtQ >* 


p\pi *nrs 

Pr LCNp 


9 4 019 X K0I 


PN T D P\C F 

U X K P C, r 


< I F r > f 


r\ p i m ki rs 

Pr LCND 








ft Fl P M ft 


9 A 019X701 




<XpGE >f 


ft cr i p m ps 

Pr t r NP 




ft T D ft V C 


< X r G T > # 


ft CI P M ft 


9 A 01 9* 1 01 


ft T PftFF 

U X PC utr 


/ T t 1 ^ 
<lPl > 9 


ft C 1 P M ft 


50 019*901 


ft T PftFT 


/Trl c w . 

^iMt * (P 


dpi rwn 


10 0I9S10I 


ft TPftrr 

y a r\ 1/ 1 r 




dpi rwn 

wr ut inu 


31 02540 


DIROEF 


<IFMDF>, 


DFLCND 


32 02550 


DIRDEF 


<IFNE 


DFLCND 


33 02«60 


DIRDEF 


<IFNZ >, 


DFLCND 


34 G2S70 


DIRDEF 


<IFT > f 


DFLCND 


35 02600 


DIRDEF 


<IFTF >f 


DFLCND 


36 02610 


DIRDEF 


<IFZ 


DFLCND 


37 02620 


DIRDEF 


<IIF > 




38 02630 


DIRDEF 


<IRP >, 


DFLMAC, 


39 02640 


DIRDEF 


<IRPC ># 


DFLMAC, 


40 02650 


DIRDEF 


<LIMIT>, 


DFLGEV 


41 02660 


DIRDEF 


<LI3T > 
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1 002670 

2 002700 

3 002710 

4 002720 

5 002730 

6 002740 

7 002750 

8 002760 

9 002770 

10 03000 

11 03010 

12 03020 

13 03030 

14 03040 

15 03050 

16 03060 

17 03070 

18 03100 

19 03100 
20 

21 

22 03110 
23 

24 000001 



WROSYMf 



PSTTOPl 



DIROEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 
DIRDEF 



<MACR >, 
<MACRO>t 
<MCALL># 
<MEXIT> , 
<NARG > , 
<NCHR > , 
<NLIS?> 
<NTYPE> , 
<DDD > 

<PAGE > 
<RRINT> 
<RADIX> 
<RAD50>, 
<REM > 
<REPT >, 
<SBTTL> 
<TITLE> 



DIRDEF <WQRD ># 



• END 



DFLMAC, XMACRO 

DFLMAC, XMACRO 

DFLSMC, XMACRO 

, XMACRO 

9 XMACRO 

9 XMACRO 

, XMACRO 



DFLGEV 

DFLMAC, XMACRO 

DFLGEV 
fTOP LIMIT 



PST 


PERMANENT 


SYMROL 


TABLE 


SYMBOL 


TARLE 








ASCII i 


i ****** 


G 




ASCIZ « 


BLKB t 


t ****** 


G 




BLKW * 


CSECT s 


i ****** 


G 




DFLCND. 


DFLGEVi 


« 000020 


G 




DFLMAC* 


DR1 i 


i 000200 






DR2 « 


ENABL i 


i ****** 


G 




END « 


ENDM i 


i ****** 


G 




ENDR ■ 


ERROR i 


i ****** 


G 




EVEN m 


FLT4 i 


i ****** 


G 




GLOBL ■ 


IF i 


i ****** 


G 




IFDF ■ 


IFF i 


8 ****** 


G 




IFG ■ 


IFGT i 


I ****** 


G 




IFL « 


IFLT i 


I ****** 


G 




IFNDF ■ 


IFNZ i 


1 ****** 


G 




IFT ■ 


IFZ i 


1 ****** 


G 




IIF ■ 


IRPC • 


1 ****** 


G 




LIMIT ■ 


MACR i 


1 ****** 


G 




MACRO « 


MEXIT « 


1 ****** 


G 




NARG ■ 


NLIST ■ 


( ****** 


G 




NTYPE * 


OPCL00I 


1 ****** 


G 




OPCL01* 


OPCL03i 


1 ****** 


G 




OPCL04« 


OPCL06* 


I ****** 


G 




OPCL07* 


OPCL09i 


1 ****** 


G 




OPCL10* 


OPCLt?« 


1 ****** 


G 




0PCL13» 


PAGE i 


1 ****** 


G 




PRINT « 


PSTTOP 


003110RG 


002 


RADIX « 


REM i 


i ****** 


G 




REPT ■ 


TITLE * 


i ****** 


G 




WORD ■ 


. APS. 


000000 




000 






000000 




001 




PSTSEC 


003110 




002 





ERRORS DETECTED! 0 
FREE CORE: 16991. WORDS 
,LPl/CRF<PST t 04A 



MACRO V*04A PAGE 64 



****** 


G 


A SECT * 


****** 


G 


****** 


G 


BYTE * 


****** 


G 


000004 


G 


DFLGBM. 


000010 


G 


0A0002 


G 


DFLSMC ■ 


000001 


G 


000100 




DSABL ■ 


****** 


G 


****** 


G 


ENDC ■ 


****** 


G 


****** 


G 


EOT « 


****** 


G 


****** 


G 


FLT2 m 


****** 


G 


****** 


G 


IDENT ■ 


****** 


G 


****** 


G 


IFEO ■ 


****** 


G 


****** 


G 


IFGF - 


****** 


G 


****** 


G 


IFLE ■ 


****** 


G 


****** 


G 


IFNF « 


****** 


G 


****** 


G 


IFTF > 


****** 


G 


****** 


G 


IPP « 


****** 


G 


****** 


G 


LIST . 


****** 


G 


****** 


G 


MCALL « 


****** 


G 


****** 


G 


NCHP • 


****** 


G 


****** 


G 


ODD ■ 


****** 


G 


****** 


G 


OPCL02« 


****** 


G 


****** 


G 


OPCL0S" 


****** 


G 


****** 


G 


OPCL0*» 


****** 


G 


****** 


G 


OPCL.lt « 


****** 


G 


****** 


G 


0PCL14. 


****** 


G 


****** 


G 


PSTBAS 


000000RG 


****** 


G 


RAD50 * 


****** 


G 


****** 


G 


SBTTL « 


****** 


G 


****** 


G 


WRDSYM 


003100RG 
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APPENDIX D 
LISTING OF SYSMAC.SML 
(SYSTEM MACRO FILE) 



I P0PM1 DOS SYSTEM MACROS V003A 

iCOPYPIRHT 1972 DIGITAL EQUIPMENT CORPORATION 

I JUNE l f 1972. 



.MACRO .PARAM 

R0»%Af>0 
RIpXaOI 
R2»%a02 
R3«%a03 
R4«%Af)4 
R5*%a05 
R6"%A06 
r7»%aD7 
SP«%a06 
PC»%a07 
PSW«a0177776 
SWR-AO1775570 
• ENDM 

.MACRO .INIT 
.MCALL .AMODE 
.AMOOE t LBLCK 
EMT <A06> 
» ENOM 



•LBLCK 



. MACRO .RUSE 
.MCALL . AMODE 
.AMODE .LBLCK 
EMT <AQ7> 
.ENDM 



.LBLCK 



. MACRO .CLOSE 
.MCALL .AMODE 
.AMODE .LBLCK 
EMT <A0i7> 
• ENDM 



.LBLCK 



.MACRO .READ 
.MCALL .AMODE 
.AMODE .LBUFF 
.AMODE .LBLCK 
EMT <A04> 
.ENDM 



.LBLCK. .LBUFF 
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.M A CRO .WRITE .LBLCK, .L«UFF 

, M C ALL « AMODE 

.AMODE .L8UFF 

.AMODE .L8LCK 

EMT <aQ2> 

• ENDM 



0 MACRO .OPENO .LBLCK, .F8LCK 

• ALL .CODE* .OPEN 

.CODE .F8LCK,<a12> 

.OPEN .LBLCK , , F8LCK 

.ENDM 

.MACRO .OPENI .LBLCK, .F8LCK 

» M C ALL .CODEt .OPEN 

•CODE .FBLCK,<a04> 

.OPEN .LBLCK * • F8LCK 
. ENDM 

.MACRO .OPENU , LBLCK * . FBLCK 

. MC ALL .CODE* • OPEN 

■CODE .F8LCK,<a01> 

.OPFN .LBLCK, .FBLCK 
. ENDM 



. MACRO .OPENC .LBLCK, .FBLCK 

.^CALL .CODE*. OPEN 

.CODE ,FBLCK,<aO!3> 

. OPEN .LBLCK, .FBLCK 

.ENDM 

.MACRO . OPENE .LBLCK, .FBLCK 

.MCALL .CODE*. OPEN 

.CODE .FBLCK, <a03> 

• OPEN .LBLCK, .FBLCK 
» ENDM 



. MACRO , OPEN .LBLCK, .FRLCK 

.MCALL . AMODE 

.AMODE .FBLCK 

.AMODE .LBLCK 

EMT <A016> 

. ENDM 



. MACRO .WAIT 
.MCALL .AMODE 
.AMODE .LBLCK 
EMT <AQ1> 
.ENDM 

.MACRO .WAIT* 
.MCALL .AMODF 
.AMODE .ADDR 
.AMODE , LBLCK 
EMT <AQ0> 
.ENDM 

.MACRO .BLOCK 
.MCALL . AMODF 
.AMODE .B8LCK 
.AMODE .L8LCK 
EMT <AOH> 
, FNDM 



.LBLCK 



.LBLCK, .ADDR 



.LBLCK, .BBLCK 
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.MACRO ,TRAN 
.MCALL .AMODE 
.AMODE .T8LCK 
.AMOOE .LBLCK 
EMT <AO10> 
■ ENOM 

.MACRO .SPEC 
.MCALL . AMODE 
.AMOOE ,SAR6 
.AMOOE ,LBLCK 
EMT <AQ12> 
.ENOM 



. LBLCK,, TBLCK 



.LBLCK, , SARG 



.MACRO .STAT , LBLCK 
.MCALL .AMODE 
.AMODE .LBLCK 
EMT <a013> 
.ENOM 



.MACRO .ALLOC .LBLCK, .FBLCK, ,N 

.MCALL .AMOOE 

, AMODE ,N 

.AMODE .FBLCK 

, AMODE .LBLCK 

EMT <A015> 

* ENDM 



.MACRO .OELET .LBLCK, .FBLCK 

.MCALL .AMODE 

.AMODE .FBLCK 

.AMODE .LBLCK 

EMT <A021> 

.ENOM 



.MACRO .RENAM .LBLCK. , OFB, . NFB 

.MCALL .AMODE 

.AMODE , NFB 

.AMODE .0F8 

.AMODE .LBLCK 

EMT <AO20> 

.ENOM 



.MACRO .APPEND 
.MCALL .AMOOE 
.AMODE ,2FB 
.AMODE ,1FB 
.AMODE .LBLCK 
EMT «A02> 
.ENOM 

.MACRO .LOOK 
.MCALL .AMODE 
.AMODE .FBLCK 
.IIF NB..OP.CLR 
.AMODE .LBLCK 
EMT «A014> 
.ENOM 



.LBLCK, .1FB..2FB 

.LBLCK, .FBLCK, , OP 
-eSP) 



.MACRO .KEEP .LBLCK, .FBLCK 
.MCALL .AMODE 
.AMODE .FBLCK 
.AMODE .LBLCK 
EMT <A024> 

• ENDM d-3 



.MACRO .EXIT 
EMT <ao60> 
• ENDM 



.MACRO . TRAP .STUB, .ADDR 

■MCALL .AMODE 

.AMODE .AOOR 

. AMODE ,STUS 

MOV *AOl,*(SP) 

EMT <AQ^t> 

. ENOM 

.MACRO .STFPU .STUSt .ADOR 

.MCALL .AMODE 

.AMODE .ADOR 

.AMODE .STUS 

MOV *A03,«(SP!) 

EMT <A041> 

.ENOM 



.MACRO .RECRD 

.MCALL . AMODE 

. AMODE .RBLCK 

. AMODE .LBLCK 
EMT <A025> 
.ENOM 

. MACRO .DUMP 

•MCALL .AMODE 

, AMODE .LOW 

.AMODE .HIGH 

.AMODE .CDE 
EMT <A064> 
.ENOM 



.LBLCK, .R9LCK 



.LOW,. HIGH,. CDE 



.MACRO .R3TRT . ADDR 

.MCALL .AMODE 

.AMODE .ADDR 

MOV #AQ!?,«(SP) 

EMT <A()4i> 

.ENDM 

.MACRO .CORE 

MOV #AOi00,*(3P) 

EMT <A04i> 

.ENOM 

.MACRO . MQNR 

MOV #AO101,-(SP) 

EMT <A04t> 

.ENDM 

.MACRO .MONF 

MOV #aq10?,*(SP) 

EMT <A04l> 

.ENDM 

.MACRO .DATE 

MOV #AO103,-(SP) 

EMT <AQ41> 

.ENDM 
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.MACRO .TIME 

MOV #aO104,-(SP) 

EMT <A041> 

.ENDM 

.MACRO .6TUIC 

MOV #AOi0S,.(SP) 

EMT «A04],> 

.ENDM 

.MACRO .9YSDV 

MOV #AO108,»(»P) 

EMT <a041> 

.ENDM 

.MACRO .RADPK . ADOR 
.MCALL .AMODE 
.AMODE ,AOOR 
CLR -(SP) 
EMT <A042> 
■ ENDM 

.MACRO .RAOUP . ADORf ,WRD 

.MCALL . AMODE 

.AMODE ,WRO 

• AMODE .ADDR 

MOV !»AOt#-CSP) 

EMT <aq42* 

.ENDM 

.MACRO .D2BIN , ADDR 

.MCALL , AMODE 

. AMODE .ADDR 

MOV #A02,-C8P) 

EMT «A042> 

• ENDM 

.MACRO .BIN2D .ADDR..WRD 

.MCALL .AMODE 

.AMODE ,WRD 

.AMODE .ADDR 

MOV *A03»*(8P) 

EMT «a042» 

.ENDM 

.MACRO .02BIN .ADDR 

.MCALL .AMODE 

.AMODE . ADDR 

MOV *AQ4,-(SP) 

EMT *A042> 

.ENDM 

.MACRO .BIN20 .ADDR..WRO 

.MCALL .AMODE 

.AMODE ,WRD 

■ AMODE . ADDR 

MOV #A05,»CSP> 

EMT «ao42> 

.ENDM 
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.macro .c3i1 .cmdbf 
• mc all .amode 
.anode .cmdbf 

EMT <A056> 

• ENDM 

.MACRO .C3I2 .CSBLK 
.MCALL .AMODE 
.AMODE .CSBLK 

EMT <A057> 

• ENDM 



.MACRO .DTCVT .ADDR 

•MCALL .CVTDT 

.CVTDT # aQ0 f .ADDR 
. ENDM 

.MACRO .TMCVT . ADDR 

.MCALL .CVTDT 

.CVTDT #A01,.ADDR 
.ENDM 



.MACRO .CVTDT . CDE, . ADDR, . VAL \ ,* VAL2 

.MCALL .AMODE 

.IF NB,.VAL2 

.AMODE .VAL2 

.ENOC 

.IF NB,.VALi 

.AMODE .VAL1 
.ENOC 

.AMODE . ADDR 

.AMODE .CDE 
EMT <A066> 
• ENDM 



.MACRO .GTPLA 
CLR *(SP) 
MOV *AQ5,-(SP) 
EMT <AQ41> 
. ENDM 

.MACRO . STPLA . ADDR 

.MCALL .AMODE 

.AMODE . ADDR 

MOV *A05,-(8P) 

EMT <A041> 

. ENDM 

.MACRO , GTCIL 

MOV #aO107,*(SP) 

EMT <A041> 

• ENDM 

.MACRO .GTST* 
CLR «*(SP) 
MOV #a04,»(SP) 
EMT <AQ41> 

• ENDM 



. MACRO . STSTK .ADDR 
.MCALL .AMODF 
.AMODE .ADDR 



D-6 



MOV *a04,*(SP) 

EMT <A041> 

.ENDM 



.MACRO .RUN .RNBLK 
.MCALL .AMODE 
.AMODE .RNBLK 

.ENDM 

.MACRO .FLUSH .CDE 

.MCALL . AMODE 

, AMODE .CDE 

EMT <A067> 

.ENDM 

THE MACRO . AMODE ACCEPTS ONE ARGUMENT AND 
AS A FUNCTION OF THE ADDRESSING MODE OF 
THE ARGUMENT GENERATES THE APPROPRIATE 
MOV TO *(SP). 

ADDRESS MODES THAT ARE TROUBLESOME (E.G. 

MSP)) OR UNLIKELY (E.G. SP) WILL RESULT 

IN A .ERROR TO CMO INCLUDING THE 

VALUE OF THE ADDRESS MODE (E.G. X(SP) 

IS REPRESENTED AS 000066), THE ARGUMENT ITSFLF 

AND THE TEXT "ADDRESSING MODE ILLEGAL AS SYSTEM 

MACRO ARGUMENT", 

.MACRO . AMODE , ARG 



8P*Xa06 



.NTYPE .SYM, .ARG 



>.SYM*ADDRESS MODE, 



.IF LE,.SYM-a05 
MOV .ARG,-CSP) 
.MEXIT 
.ENDC 



*R0 TO R5 



• IF EQ, .SYMaAO70*AOl0 
. IF LE, ,SYM8,a07*a06 
MOV .ARG,«*(SP) 



|*R0 TO *P6 



.MEXIT 
.ENDC 
.ENDC 



.IF EO, .SYM&aO60«aO20 
MOV .ARG#»(SP) 
.MEXIT 
.ENDC 



l t#J(R0)* TO r*l(R7)+ 
1 UH f 0# ADDR 



.IF EO, ,SYM&aO40«aQ40 
•IF LE# ,SYM&a07*a05 
MOV .ARG#*(SP) 



> r»i-(R0) to r#wR5) 

9 t#1 XCR0) TO f*1X(R5) 



.MEXIT 
.ENDC 
.ENDC 



.IF EQ # ,SYM&a067*a067 
MOV .ARG,*(SP) 
.MEXIT 
.ENDC 



>ADDR AND OADOR 
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.ERROR .3YM 

.PRINT 

,ENDM 



I .ARC ADDRESSING MODE ILLEGAL 
I AS SYSTEM MACRO ARGUMENT. 



I THE MACRO .CODE SETS UP THE FILEBLOCK 

» WITH THE HOW OPEN CODE, 

t THE AOORESS OF THE FILEBLOCK MUST 

» BE IN A REGISTER (R0 TO R5) 

.MACRO .CODE .FBLK..N 
.NTYPE .SYM..FBLK 

.IF LE,.SYM-a05 

MOVB #.N#»A02(.FBLK) TO R5 

.MEXIT 



.ENDC 



.ERROR .SYM 
. PRINT 
.ENDM 



J.FBLK ADDRESSING MODE ILLEGAL 
t FOR .OPEN FILE BLOCK 
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APPENDIX E 



ERROR MESSAGE SUMMARY 



E.l MACRO- 11 ERROR CODES 

MACRO-11 error codes are printed following a field of six 
asterisk characters and on the line preceeding the source line 
containing the error. For example: 
** ** **a 

26 J00236 JB0J00JB2' . WORD REL1+REL2 
The addition of two relocatable symbols is flagged as an A error. 

Error Code Meaning 

A Addressing error. An address within the instruc- 

tion is incorrect. Also may indicate a relocation 
error. 

B Bounding error. Instructions or word data are 

being assembled at an odd address in memory. The 
location counter is updated by +1. 

D Doubly-defined symbol referenced. Reference was 

made to a symbol which is defined more than once. 

E End directive not found. (A listing is generated.) 

I Illegal character detected. Illegal characters 

which are also non-printing are replaced by a ? 
on the listing. The character is then ignored. 

L h^ ne k uffe r overflow, i.e., input line greater 

than 132 characters. Extra characters on a line, 
(more than 72 are ignored. 

M Multiple definition of a label. A label was en- 

countered which was equivalent (in the first six 
characters) to a previously encountered label. 

N Number containing 8 or 9 has decimal point missing. 

0 Opcode error. Directive out of context. 

P Phase error. A label's definition of value varies 

from one pass to another. 

Q Questionable syntax. There are missing arguments 

or the instruction scan was not completed or a 
carriage return was not immediately followed by 
a line feed or form feed. 

R Register-type error. An invalid use of or refer- 

ence to a register has been made. 
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Error Code 



Meaning 



T Truncation error. A number generated more than 

16 bits of significance or an expression genera- 
ted more than 8 bits of significance during the 
use of the .BYTE directive. 

U Undefined symbol. An undefined symbol was en- 

countered during the evaluation of an expression. 
Relative to the expression, the undefined symbol 
is assigned a value of zero. 

Z Instruction which is not compatible among all 

members of the PDP-11 family (11/15, 11/20, 
11/45) . 



E.2 SYSTEM ERROR MESSAGES 



Error Code Meaning 
S217 Insufficient cofe space. 

5202 Binary or listing device full. 

5203 Illegal switch 
Too many switches 
Illegal switch value 
Too many switch values 

S2J04 Too many output file specifications 

S206 No source files specified. 
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INDEX 



Absolute addressing mode, 1-7, 1-9, 

5- 5 

Absolute address mode function, 6-13 
Absolute binary output function, 

6- 13 

Absolute program section, 6-33 
Addressing modes, 5-1,5-7 

branch instructions, 5-7 

position independent, 1-6 

preferred, 1-11 

syntax summary, B-2 
Angle brackets, 7-4,7-5,7-7 
Apostrophe 

ASCII conversion, 6-17 

concatenation operator, 7-10 

in system symbols, 1-9, 1-10 

Linker supplied, 4-1 
Argument 

concatenation , 7-10 

delimiters, 3-2 

macro, 7-4 
ASCII character set, A-l 
ASCII conversions 

character string, 6-19 

one character, 6-17 

two characters, 6-17 
.ASCII directive, 6-19 
.ASCIZ directive, 6-20 
.ASECT directive, 6-32, 6-33 
Assembler directive summary, B-14 
Assembler functions, 6-13 
Assembly listing, see listing 
Automatically created symbols, 7-9 



Background material references, 1-1 
Backslash character, 7-7 
Binary extension listing control, 
6-2 

Binary listing control, 6-2 
Binary output enable/disable 

function, 6-13 
Binary radix number, 6-23 
Blank lines in assembly listing, 2-1 
Block storage directives, 6-25 
. BLKB directive, 6-25 
. BLKW directive, 6-2 5 
Branch instruction addressing, 

5-7, B-9 
.BYTE directive 6-15 



Calls to macros, 7-3 
Character set, 3-1 
Comments, 1-2 

comment field, 2-4 
listing control, 6-2 
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Command string, 8-1 

errors in, 8-2 
Common data areas, 6-34 
Complement (one's) operator, 6-2 8 
Concatenation operator, 7-10 
Conditional assemblies, 1-4, 6-37 

immediate conditionals, 6-39 

PAL-11R conditionals, 6-40 

subconditionals , 6-38 
Conditional block listing control, 

6-3 

Conditional branches, 1-13 

Conventions , 

addressing modes, 1-11 
conditional branches, 1-13 
parameter assignments, 1-12,3-8 
space vs* timing, 1-13 
stack usage, 1-3 

CREF, 8-3 

Cross reference table (CREF) , 8-3 
.CSECT directive, 6-32 



Data storage directives, 6-15 
Decimal radix number, 6-23 
Default file specifications, 8-2 
Delimiting characters, 3-2 
Direct assignment, 3-7, 6-36 
Directive summary, B-14 
Dispatch table, 1-13 

Dollar sign ($) character, 2-3, 3-1, 

3-5, 3-10 
Dot (.) character , 2-3, 3-1, 3-5, 

3-12 

as decimal point, 6-23 
Double operand instructions, B-4 
Double register-destination 

instructions , B-13 
/DS, 8-3 

. DSABL directive, 6-13 



Edit-11, 2-1, 2-2, 2-5, 6-12 
EMT, 5-8 
/EN, 8-3 

. ENABL directive, 6-13 

.END directive, 6-30 

. ENDC directive, 6-37 

. ENDM directive, 7-2, 7-16 

. ENDR directive, 7-18 

.EOT directive, 6-30 

Error codes , E-l 

. ERROR directive, 7-13 

Error message summary, E-l 

.EVEN directive, 6-24 

Expressions, 3-15 

absolute, 3-16 

relocatable, 3-16 

external, 3-16 



File specif ications , 8-2 
Flowcharting , 1-1 
Floating point 

function, 6-13 

number operator (+F) , 6-2 8 

numbers, 6-2 6 

source-double register instruc- 
tions, B-ll 
• FLT2 directive, 6-27 
. FLT4 directive, 6-27 
Format control of source program, 

2-5 

Forward references, 

defining location counter, 3-12 
in direct assignments, 3-7 

Functions, assembler, 6-13 

Global symbols, 3-6, 6-34, 6-35 

. GLOBL directive, 6-35 



.IDENT directive, 6-10 

•IF directive, 6-37 

.IFF directive, 6-38 

• IFT directive, 6-38 

. IFTF directive, 6-38 

. IIF directive, 6-40 

Illegal character, 3-3 

Immediate addressing mode, 1-7, 

1-10, 5-4 
Immediate conditionals, 6-39 
Indefinite repeat blocks, 7-14 
Index addressing modes, 1-7, 1-10, 

5- 4 

Instruction summary, B-3 
.IRP directive, 7-14 
.IRPC directive, 7-17 

Labels, 6-32, 7-1 

label field, 2-2 
/LI, 8-3 

.LIMIT directive, 6-31 

Line printer assembly listing 

control, 6-3 
Link-11, 1-9, 6-13, 6-33, 6-35 

apo s t r ophe , 4-1 

label assignments, 2-2 
.LIST directive, 6-1 
Lisitng, 

apostrophe, 1-9, 4-1 

blank lines, 2-1 

control, 6-1 

control of listing directives ,6- 

Table of Contents, 6-3 
Loading MACRO-11, 8-1 
Local register usage, 1-4 
Local symbol block function, 6-13 
Local symbols, 3-9, 7-9 
Location counter, 3-12, 6-32 , 6-33 

control, 6-24 

listing control, 6-2 
Lower case ASCII input function, 

6- 13 



Macros , 

arguments, 7-4, 7-8 

calls, 7-3 

definition, 7-1 

formatting definition, 7-3 

nesting, 7-5 

terminating, 7-2 
Macro arguments, 

automatically created local 
symbols, 7-9 

concatenation of, 7-10 

delimiters, 7-4, 7-5 

determining addressing modes, 7-1 

determining number of characters 
in, 7-11 

determining number of, 7-11 

numeric arguments passed as 
symbols, 7-7 
Macro call and expansion listing 

control, 6-2 
Macro definitions, 7-1 

listing control, 6-2 
.MACRO directive, 7-1 
Macro expansion 

binary listing control, 6-3 

listing control, 6-3 
Macro libraries, 7-18 
Macro symbols, 3-5, 3-6 
. MC ALL directive, 7-18 
.MEXIT directive, 7-2, 7-18 
Modular programming, 1-1 



.NARG directive, 7-11 
.NCHR directive, 7-11 
/NL, 8-3 

•NLIST directive, 6-1 
. NTYPE directive, 7-11 
Numeric control, 6-26 
Numeric string symbols, 7-7 
Number instruction (MARK) , B-13 
Numbers, 3-15 

Number sign (#) character, 3-12 



Octal radix, 3-13 

number operator (+0) , 6-2 3 
.ODD directive, 6-24 
One 1 s complement number operator 

(+C) , 6-28 
Operand field, 2-4 
30perate instructions, B-7 
Operating procedures, 8-1 
Operator characters, 

+ , 3-3 

-, 3-3 

*, 3-4 

/, 3-4 

&, 3-4 

I , 3-4 

+ , 3-4 
Operator field, 2-3 
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• PAGE directive , 6-12, 7-3 
Page ejection, 6-12 , 7-3 
Page format, 6-12 
Page headings, 6-7 
Period, see Dot 
Permanent symbols, 3-5, 3-6 
Permanent symbol table listing, C-l 
PIC, see Postion independent code 
Position independent code, 1-6 
.PRINT directive, 7-13 
Priority instruction, B-14 
Program sections, 3-6 
directives, 6-32 



Q errors, 3-3 

Quote (") character, 6-17 



Radix control, 6-22 

temporary, 6-28 
. RADIX directive 6-22 
RADIX-50 character set, A-4 
. RAD50 directive, 6-20 
Recursive code, 1-11 
Reentrant code, 1-11 
Register addressing modes, 1-6, 

5- 2, 5-3 

storage savings on, 1-11, 1-12 
Register destination instructions, 
B-10 

Register increment operation, 1-13 
Register offset instructions, B-10 
Register symbols, 3-8 
Register usage, 1-4, 1-9 
Relative addressing modes, 1-7, 

1-10, 5-5, 5-6 
Relocatable program sections, 6-32, 

6- 34 

Relocation of code, 4-1 
Repeat blocks, 7-17 
• REPT directive, 7-17 



Symbol table listing control, 6-3 

Symbols , 

automatically created, 7-9 
evaluation of, 3-14, 3-6 
global, 3-6, 6-34, 6-35 
local, 3-9, 7-9 
macro, 3-5 
numeric strings, 7-7 
permanent, 3-5, 3-6, C-l 
program section names, 6-34 
user-defined, 3-5, 3-6, 3-7 

SYSMAC.SML file, 7-18 
listing of, D*-l 

System error messages, E-2 



Tab character, 2-2 
Teletype mode listing control, 6-3 
Temporary radix control, 6-22, 6-28 
Terms, 3-14 

Terminating characters, 2-3, 2-4 
•TITLE directive, 6-7 
Trap handler, 1-13, 5-8 
Trap instructions, B-9 



Undefined symbols, 6-33 
Up arrow (+) character, 6-22, 6-2 8, 
7-5 

User-defined symbols, 3-5, 3-6, 3-7 



.WORD directive, 6-16 



Z error code, 5-3 



• SBTTL directive, 6-10 
Sections, see Program sections 
Separating characters, 3-2 
SEQ argument to .LIST/.NLIST, 6-2 
Sequence number listing control, 6-2 
Single operand instructions , B-5 
Source listing control, 6-2 
Source-double register instructions, 
B-12 

Source register instructions, B-ll 
Special character summary, B-l 
Statement format, 2-1 
Statement terminators, 2-1 
Stack usage, 1-3 
Subconditionals , 6-38 
Subroutines, 1-1 

Subroutine return instruction, B-10 
Switch options, 6-6, 8-3 
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HOW TO OBTAIN SOFTWARE INFORMATION 



Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 

Digital Software News for the PDP-11 

Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Pro^mm Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 

DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 
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